Getting Started

Local Development

Day-to-day development flow for app, API, and docs in one repo.

Daily workflow

bun install
bun run dev

Useful scripts

bun run typecheck
bun run lint
bun run build
bun run db:generate
bun run db:migrate

Docs workflow

Docs source: apps/ship/content/docs
Fumadocs config: apps/ship/source.config.ts
Search API: apps/ship/src/app/api/docs/search/route.ts

After editing docs source, regenerate runtime source:

cd apps/ship
bun run postinstall

Debug tips

For auth issues, inspect packages/auth or packages/auth-clerk and callback/webhook URLs.
For wallet/subscription issues, inspect Stripe webhook logs first.
For admin dashboard issues, verify DB connectivity before checking SQL logic.

Project Structure

Ownership boundaries and collaboration model across product domains.

Configuration

Environment variables and runtime configuration layers.

On this page