Skip to content
Bookmarks Docs

Local Setup

Local Setup

Section titled “Local Setup”

1. Worker API

Section titled “1. Worker API”
Terminal window
cd workers/bookmarks-api-worker
yarn install
wrangler d1 create bookmarks
# Paste returned database_id into wrangler.toml

Apply all migrations in order:

Terminal window
wrangler d1 migrations apply bookmarks --local

Seed local data:

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

2. Flutter App

Section titled “2. Flutter App”
Terminal window
cd apps/bookmarks_app
flutter pub get
flutter run --dart-define=API_BASE_URL=http://127.0.0.1:8787

3. Astro Site

Section titled “3. Astro Site”
Terminal window
cd apps/bookmarks_site
yarn install
yarn dev

Environment references

Section titled “Environment references”
  • Flutter: apps/bookmarks_app/.env.example
  • Astro: apps/bookmarks_site/.env.example
  • Worker: workers/bookmarks-api-worker/.dev.vars.example

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

Local verification checklist

Section titled “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