nekomimi.pet / wisp.place-monorepo
Monorepo for wisp.place. A static site hosting service built on top of the AT Protocol. wisp.place
fork atom
TypeScript 86.3%
Rust 10.4%
HTML 1.6%
CSS 1.1%
Shell 0.4%
Dockerfile 0.2%
Other 0.1%
68 5 1

Clone this repository

https://tangled.org/nekomimi.pet/wisp.place-monorepo
git@knot.gaze.systems:nekomimi.pet/wisp.place-monorepo

For self-hosted knots, clone URLs may differ based on your setup.

Download tar.gz
README.md

Wisp.place#

Decentralized static site hosting on the AT Protocol. https://wisp.place

What is this?#

Host static sites in your AT Protocol repo, served with CDN distribution. Your PDS holds the cryptographically signed manifest and files - the source of truth. Hosting services index and serve them fast.

Quick Start#

# Using the web interface
Visit https://wisp.place and sign in

# Or use the CLI
cd cli
cargo build --release
./target/release/wisp-cli your-handle.bsky.social --path ./my-site --site my-site

Your site appears at https://sites.wisp.place/{your-did}/{site-name} or your custom domain.

Architecture#

  • /src - Main backend (OAuth, site management, custom domains)
  • /hosting-service - Microservice that serves cached sites from disk
  • /cli - Rust CLI for direct PDS uploads
  • /public - React frontend

How it works#

  1. Sites stored as place.wisp.fs records in your AT Protocol repo
  2. Files compressed (gzip) and base64-encoded as blobs
  3. Hosting service watches firehose, caches sites locally
  4. Sites served via custom domains or *.wisp.place subdomains

Development#

# Backend
bun install
bun run src/index.ts

# Hosting service
cd hosting-service
cargo run

# CLI
cd cli
cargo build

Limits#

  • Max file size: 100MB (PDS limit)
  • Max site size: 300MB
  • Max files: 2000

Tech Stack#

  • Backend: Bun + Elysia + PostgreSQL
  • Frontend: React 19 + Tailwind 4 + Radix UI
  • Hosting: Rust microservice
  • CLI: Rust + Jacquard (AT Protocol library)
  • Protocol: AT Protocol OAuth + custom lexicons

License#

MIT