aly.codes / atbbs
Retro Bulletin Board Systems on atproto. Web app and TUI. lazy mirror of alyraffauf/atbbs atbbs.xyz
forums python tui atproto bbs
3
fork

Configure Feed

Select the types of activity you want to include in your feed.

atbbs / web /
at master 2 folders 9 files
public
src
README.md
docker-entrypoint.sh
index.html
lex.config.js
nginx.conf
package-lock.json
package.json
tsconfig.json
vite.config.ts
README.md

atbbs web#

Static React SPA. No backend — reads go to Slingshot/Constellation, writes go to the user's PDS via atproto OAuth.

Development#

cd web
npm install
npm run dev

OAuth works automatically on http://127.0.0.1:5173 via atproto's loopback client flow.

Production#

Static deploy (Cloudflare Pages, etc.)#

VITE_PUBLIC_URL=https://your-domain.com npm run build

Deploy dist/. The _redirects file handles SPA routing on Cloudflare Pages.

Docker#

docker run -d -p 8080:80 -e PUBLIC_URL=https://your-domain.com ghcr.io/alyraffauf/atbbs:latest

The entrypoint generates config.json and client-metadata.json at runtime from PUBLIC_URL.

OAuth#

https://your-domain.com/client-metadata.json must be publicly fetchable — atproto auth servers fetch it during the OAuth handshake.