home to stumble.at - check out random atmosphere apps listed in atstore.fyi
README.md

Stumble #

Stumble onto a random app from the Atmosphere: apps built on the AT Protocol, from the atstore.fyi directory. Live at https://stumble.at.

Sign in with a Bluesky or other AT Proto account to keep your last 5 apps and save favorites. These are stored as records in your own repo (see lexicons/).

Develop #

npm install
npm run dev

Open http://127.0.0.1:3000 (not localhost): AT Proto OAuth's loopback client requires the 127.0.0.1 origin.

Deploy #

Pushing to main runs .tangled/workflows/check.yml, which builds and deploys to Vercel with the Vercel CLI. The workflow needs three Tangled secrets: VERCEL_TOKEN, VERCEL_ORG_ID and VERCEL_PROJECT_ID.

How it fits together #

  • app/page.tsx: the page. UI lives in src/components/.
  • app/api/random: picks a random app from atstore.fyi (cached server-side).
  • app/api/typeahead: account suggestions for the sign-in box.
  • app/xrpc/com.atproto.identity.resolveHandle: resolves handles on this server, so sign-in doesn't send users' handles to a third party.
  • app/oauth-client-metadata.json: the OAuth client metadata. Its URL is the client_id, so it must be served from https://stumble.at without redirects.