Wisp.place - Decentralized Static Site Hosting

  Architecture Overview

  Wisp.Place a two-service application that provides static site hosting on the AT
  Protocol. Wisp aims to be a CDN for static sites where the content is ultimately owned by the user at their repo. The microservice is responsbile for injesting firehose events and serving a on-disk cache of the latest site files.

  Service 1: Main App (Port 8000, Bun runtime, elysia.js)
  - User-facing editor and API
  - OAuth authentication (AT Protocol)
  - File upload processing (gzip + base64 encoding)
  - Domain management (subdomains + custom domains)
  - DNS verification worker
  - React frontend

  Service 2: Hosting Service (Port 3001, Node.js runtime, hono.js)
  - AT Protocol Firehose listener for real-time updates
  - Serves hosted websites from local cache
  - Multi-domain routing (custom domains, wisp.place subdomains, sites subdomain)
  - Distributed locking for multi-instance coordination

  Tech Stack

  - Backend: Bun/Node.js, Elysia.js, PostgreSQL, AT Protocol SDK
  - Frontend: React 19, Tailwind CSS v4, Shadcn UI

  Key Features

  - AT Protocol Integration: Sites stored as place.wisp.fs records in user repos
  - File Processing: Validates, compresses (gzip), encodes (base64), uploads to user's PDS
  - Domain Management: wisp.place subdomains + custom BYOD domains with DNS verification
  - Real-time Sync: Firehose worker listens for site updates and caches files locally
  - Atomic Updates: Safe cache swapping without downtime