Migrating from Demo Template to Bun-Native Docs

Older versions of this project mixed framework experiments, demo app code, and docs concerns together. The current direction is stricter.

Migration goals

• keep the docs site as the primary product surface
• move authored docs into app/routes/docs/**/*.md
• keep generated assets under .rbssr/ and dist/
• use Bun-first runtime helpers consistently

Typical migration steps

1. Move ad-hoc pages into app/routes.
2. Replace generic anchors with Link for internal navigation.
3. Move route-specific styling into CSS Modules.
4. Replace custom markdown plumbing with first-class .md routes.
5. Regenerate API docs and search artifacts.

Validation checklist

bun run test
bun run docs:check
bun run docs:build

Related guides

• Project Structure
• File-Based Routing
• CSS Modules

Next step

Return to Overview if you want to follow the new documentation flow from the beginning.