Project roadmap

A small Bun-native React SSR framework, intentionally grown in public.

`react-bun-ssr` is experimental. The roadmap focuses on making the current SSR, routing, data, and deployment model more credible before expanding the framework surface.

Direction

Stabilize the useful core before widening the surface.

Stable enough to evaluate now

  • Bun-native SSR runtime and production server entrypoints
  • File-based page, API, layout, group, and markdown routes
  • Server loaders, React form actions, middleware, and response helpers
  • Streaming SSR, deferred loader data, and soft client transitions
  • Docs-first project structure with generated API docs and search index

Near-term focus

  • More evergreen examples and comparison pages for common adoption decisions
  • Tighter SEO and structured-data checks as part of docs validation
  • More production deployment notes for Bun hosting environments
  • More request-runtime boundary tests around document projection and transitions
  • Clearer release notes and migration notes as APIs stabilize

Current non-goals

  • Do not become a clone of Next.js or Remix.
  • Do not hide Bun behind a generic Node adapter model.
  • Do not add React Server Components until the framework has a coherent Bun-native story for them.
  • Do not optimize for every hosting platform before the core runtime is stable.
  • Do not turn the docs site into a demo-first marketing app.

Evaluate safely

Use the docs, examples, and benchmarks before adopting it broadly.

The safest path is to build the Task Tracker, review the benchmark scope, and compare the framework honestly with Next.js before deciding whether the Bun-native tradeoff fits.