slipnote.app / slipnote
Built for people who think better out loud.
fork atom
slipnote / README.md
at main 1.8 kB view raw view code
isaaccorbrey.com logging: Add request log sampling controls
34dd2b42

slipnote#

Monorepo layout:

  • frontend/: Astro frontend
  • backend/: Rust Axum backend

Frontend#

cd frontend
pnpm install
pnpm dev

Backend#

cd backend
cargo run

OAuth env vars#

The backend requires these OAuth settings to enable ATProto auth:

  • OAUTH_CLIENT_ID (e.g. https://your-app.com/oauth/client-metadata.json)
  • OAUTH_REDIRECT_URI (e.g. https://your-app.com/oauth/callback)
  • OAUTH_SIGNING_KEY (did:key private key for client assertions)

Generate a signing key with the built-in helper:

cd backend
cargo run --bin oauth_keygen

Set the output as OAUTH_SIGNING_KEY.

Optional settings:

  • SLIPNOTE_LOG_SAMPLE_RATE (defaults to 1.0)
  • OAUTH_BASE_URL (if set, derives OAUTH_CLIENT_ID, OAUTH_REDIRECT_URI, and OAUTH_JWKS_URI)
  • OAUTH_CLIENT_NAME
  • OAUTH_CLIENT_URI
  • OAUTH_JWKS_URI
  • OAUTH_SCOPES (defaults to atproto transition:generic)
  • OAUTH_POST_AUTH_REDIRECT (defaults to OAUTH_BASE_URL when set, otherwise /)
  • OAUTH_POST_AUTH_REDIRECT_ROUTE (if set, combines with OAUTH_BASE_URL when available)
  • OAUTH_COOKIE_NAME (defaults to slipnote_session)
  • OAUTH_SESSION_TTL_SECONDS (defaults to 7 days)
  • PLC_HOSTNAME (defaults to plc.directory)

If you do not have a real URL for OAuth callbacks, expose the backend with ngrok:

ngrok http 3001

Then set OAUTH_BASE_URL to the ngrok HTTPS URL (for example, https://abc123.ngrok-free.app).

Tilt#

tilt up

Tilt runs the frontend dev server, Storybook, and the backend as local resources. Tilt also launches a Postgres container and wires DATABASE_URL for the backend. Set OPENAI_API_KEY for the backend and optionally override SLIPNOTE_BACKEND_URL, DATABASE_URL, or PUBLIC_BACKEND_URL/ VITE_BACKEND_URL.