Local setup
Prerequisites
Section titled “Prerequisites”- Bun 1.3.11 or newer in the 1.3 line.
- PostgreSQL 16 with PostGIS.
- Valkey or Redis.
- Meilisearch for location search.
- S3-compatible storage and imgproxy only when working on image upload or production-like media flows.
Clean clone
Section titled “Clean clone”bun installbun --filter @repo/database db:generateCopy the root env template only when you need to run apps against local services:
cp .env.example .env.localNever paste secrets into docs or committed files. The source of truth for variable meaning is Settings → Environment variables.
First local runs
Section titled “First local runs”| Surface | Command | Notes |
|---|---|---|
| Docs | bun --filter @repo/docs dev | Runs generators first, then Astro/Starlight. |
| Web | cd apps/svelte-web && bun run dev | Main SvelteKit app. |
| API | bun --filter api dev | Hono host for Better Auth and tRPC. |
| Worker | bun --filter worker dev | BullMQ jobs; use matching QUEUE_SUFFIX in dev. |
For a docs-only onboarding loop, run bun --filter @repo/docs build first. It validates MDX, generated API pages, Knock workflow pages, design tokens, and the generated workspace inventory.
Native app note
Section titled “Native app note”The native iOS and Android apps are product apps but not Bun workspaces. Use their Xcode/Gradle commands and the native CI workflows. They still depend on the shared API contract and synced i18n catalogs.