Bosbun

A fast, batteries-included fullstack framework — SSR · Svelte 5 Runes · Bun · ElysiaJS.

File-based routing inspired by SvelteKit, built on top of the Bun runtime and ElysiaJS HTTP server. No Node.js, no Vite, no adapters.

Features

• File-based routing — +page.svelte, +layout.svelte, +server.ts, route groups, dynamic segments, catch-all routes
• Server-side rendering — every page is rendered on the server with full hydration
• Server loaders — +page.server.ts and +layout.server.ts with parent() data threading
• API routes — +server.ts exports HTTP verbs (GET, POST, PUT, PATCH, DELETE, OPTIONS)
• Middleware hooks — hooks.server.ts with sequence() for auth, logging, locals
• Dev server with HMR — file watcher + SSE browser reload, no page blink
• Tailwind CSS v4 — compiled at build time, shadcn-inspired design tokens out of the box
• CLI — bosbun create, bosbun dev, bosbun build, bosbun add, bosbun feat

Documentation

Full documentation available at bosbun.bosapi.com.

• Getting Started
• Project Structure
• Routing
• Server Loaders
• API Routes
• Form Actions
• Middleware Hooks
• Environment Variables
• Styling
• Security
• CLI Reference
• API Reference
• Deployment
• SvelteKit Differences

Monorepo Structure

bosbun/
├── apps/
│   └── demo/          # Example app showing routing, loaders, API, hooks
└── packages/
    └── bosbun/         # Framework package (CLI + core + templates)

Quick Start

# Scaffold a new project
bun x bosbun create my-app
cd my-app

# Start development
bun run dev

# Build for production
bun run build
bun run start

See Getting Started for a full walkthrough.

Tech Stack

Layer	Technology
Runtime	Bun
HTTP Server	ElysiaJS
UI	Svelte 5 (Runes)
CSS	Tailwind CSS v4
Bundler	Bun.build

Monorepo Development

# Install all workspace dependencies
bun install

# Run the demo app in dev mode
cd apps/demo
bun run dev

Roadmap

See ROADMAP.md for what's done, what's next, and the full plan toward production readiness.

License

MIT