Architecture

Monorepo layout

sawdust/
├── projects/
│   ├── doc-site/      # this site (Astro + Starlight)
│   └── ...            # other workspace packages
├── bun.lock
└── package.json

Runtime stack

Layer	Choice	Why
Package mgr	Bun	Fast install, native TS
Web server	Bun.serve	Built-in, no Express
DB driver	Bun.sql	Native Postgres
Doc site	Astro + Starlight	Vite bundler, ESM-first

Build pipeline

1. bun install resolves workspace deps.
2. Each package runs its own build script.
3. Static output deploys independently.

Data flow

flowchart LR
    A[Markdown source] --> B[Astro build]
    B --> C[Static HTML]
    C --> D[CDN]
    D --> E[User browser]