Local Setup

Local Setup

1. Worker API

cd workers/bookmarks/api
yarn install
wrangler d1 create bookmarks
# Paste returned database_id into wrangler.toml

Apply all migrations in order:

wrangler d1 migrations apply bookmarks --local

Seed local data:

wrangler d1 execute bookmarks --local --file=./seeds/seed.sql
wrangler dev

2. Flutter App

cd apps/bookmarks/app
flutter pub get
flutter run --dart-define=API_BASE_URL=http://127.0.0.1:8787

If logo assets changed, regenerate native launcher icons:

cd apps/bookmarks/app
dart run flutter_launcher_icons

3. Astro Site

cd apps/bookmarks/site
yarn install
yarn dev

Environment references

• Flutter: apps/bookmarks/app/.env.example
• Astro: apps/bookmarks/site/.env.example
• Worker: workers/bookmarks/api/.dev.vars.example

Keep local URLs aligned across app and worker so auth and API calls resolve consistently.

Local verification checklist

• GET /health returns ok: true
• Login succeeds (/v1/auth/login or /v1/auth/dev-login in dev mode)
• GET /v1/clubs returns data for authenticated user
• Creating a club succeeds and returns clubId
• Club websocket stream connects for a member
• Closing/reopening app resumes by reconnecting websocket stream