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 67.1%
Rust 27.6%
HTML 2.1%
CSS 0.9%
MDX 0.9%
Nix 0.5%
Dockerfile 0.2%
Shell 0.2%
JavaScript 0.1%
Other 0.3%
150 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#

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

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 will install packages across the monorepo
bun install
bun run dev

# Hosting service
bun run hosting:dev

# CLI
cd cli
cargo build

Features#

File Filtering and .wispignore#

Wisp automatically excludes common files that shouldn't be uploaded to your site (like .git, node_modules, .env files, etc.). You can customize this behavior by creating a .wispignore file in your site root.

The .wispignore file uses the same syntax as .gitignore:

# Custom ignore patterns
*.log
temp/
build/
.secret

Default patterns include: .git, .github, .gitlab, .DS_Store, node_modules, .env, cache directories, Python virtual environments, editor swap files, .tangled, and more.

See File Filtering Documentation for details.

URL Redirects and Rewrites#

The hosting service supports Netlify-style _redirects files for managing URLs. Place a _redirects file in your site root to enable:

  • 301/302 Redirects: Permanent and temporary URL redirects
  • 200 Rewrites: Serve different content without changing the URL
  • 404 Custom Pages: Custom error pages for specific paths
  • Splats & Placeholders: Dynamic path matching (/blog/:year/:month/:day, /news/*)
  • Query Parameter Matching: Redirect based on URL parameters
  • Conditional Redirects: Route by country, language, or cookie presence
  • Force Redirects: Override existing files with redirects

Example _redirects:

# Single-page app routing (React, Vue, etc.)
/*                 /index.html           200

# Simple redirects
/home              /
/old-blog/*        /blog/:splat

# API proxy
/api/*             https://api.example.com/:splat     200

# Country-based routing
/                  /us/                  302  Country=us
/                  /uk/                  302  Country=gb

Limits#

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

Tech Stack#

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

License#

MIT