Docs.surf#

A monorepo for indexing and displaying Standard.site documents from the AT Protocol, powered by Cloudflare Workers, D1, and Queues.

Components:

1. Tap Indexer (External) - Subscribes to the AT Protocol firehose and sends webhook events
2. Server (packages/server) - Cloudflare Worker with Hono API, D1 database, and Queue consumer
3. Client (packages/client) - Vite + React app deployed to Cloudflare Pages

Local Development#

1. Start the worker locally:

bun run dev:server

The API will run on http://localhost:8787.

2. Start the client (in a separate terminal):

bun run dev:client

The client will run on http://localhost:5173.

How It Works#

1. Tap subscribes to the AT Protocol firehose and filters for site.standard.document records
2. Webhook receives events and stores record references in D1, then pushes to the resolution queue
3. Queue consumer resolves each document (PDS lookup → record fetch → publication URL) and stores in resolved_documents
4. Cron job (every 15 min) refreshes stale documents and processes any missed records
5. /feed endpoint reads directly from resolved_documents for instant responses

Resources#

• tap Documentation
• AT Protocol Specs
• Cloudflare Workers
• Cloudflare D1
• Cloudflare Queues
• Hono Documentation

License#

MIT