# Docs.surf

![cover](./packages/client/public/og.png)

A monorepo for indexing and displaying [Standard.site](https://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:

```bash
bun run dev:server
```

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

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

```bash
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](https://github.com/bluesky-social/indigo/tree/main/cmd/tap)
- [AT Protocol Specs](https://atproto.com/)
- [Cloudflare Workers](https://developers.cloudflare.com/workers/)
- [Cloudflare D1](https://developers.cloudflare.com/d1/)
- [Cloudflare Queues](https://developers.cloudflare.com/queues/)
- [Hono Documentation](https://hono.dev/)

## License

MIT