flowbun.dev

The website for Flowbun — landing page plus docs. Built with Astro and Starlight, served at https://flowbun.dev.

Develop

bun install
bun run dev      # dev server on :4321
bun run build    # static build into dist/
bun run preview  # serve the built dist/

Deploying (Cloudflare Workers, static assets)

This is a fully static site — wrangler.jsonc deploys dist/ as plain static assets, with no Worker script and no SSR adapter. In the Cloudflare project's build settings (GitHub-linked Workers Builds):

• Build command: bun run build
• Deploy command: npx wrangler deploy
• Custom domain: flowbun.dev

No environment variables are required.

Do not add @astrojs/cloudflare (and undo Cloudflare's auto-setup if it injects it): the adapter switches Astro's image handling from build-time pre-generation to a runtime /_image endpoint that a static-assets deployment doesn't serve — images 404. The plain static build pre-bakes every image variant into dist/_astro/*.webp.

Note: bun run build on this repo's own dev machine (Asahi Linux, 16K page size) skips the Pagefind search index — Pagefind's prebuilt binary crashes with jemalloc: Unsupported system page size there. Cloudflare's x86-64 build runners are unaffected, so production builds get docs search; it's only absent from local previews.

Structure

• src/pages/index.astro — the landing page (self-contained, scoped styles)
• src/content/docs/docs/ — docs content (Markdown, rendered by Starlight under /docs/)
• astro.config.mjs — site config, docs sidebar
• src/assets/, public/ — images from the main flowbun repo