Framework

Manic is a zero-config React SPA framework built exclusively on Bun with ultra-fast OXC transforms, Hono API routes, and native View Transitions support.

Quick Start

bun create manic my-app
cd my-app
bun dev

npx create-manic my-app
cd my-app
npm install
npm run dev

yarn create manic my-app
cd my-app
yarn dev

pnpm create manic my-app
cd my-app
pnpm dev

Visit http://localhost:6070 (default dev port; override with server.port or manic dev --port)

What You Get

• Client Router — File-based routing with lazy-loaded code splitting
• API Routes — Hono-powered, fully typed OpenAPI
• Build Engine — OXC transforms + Bun bundler (50-100x faster than alternatives)
• Zero Config — Just write code, the framework figures out the rest
• View Transitions — Native, flicker-free page navigation
• TypeScript First — Full type safety across router, API, and config

Project Structure

Next Steps

Key Concepts

The ~ Convention

Files and folders prefixed with ~ are excluded from routing. Use them for components, utilities, and tests:

Auto-Generated Routes

Your folder structure automatically becomes your API and site structure:

• app/routes/blog/[slug].tsx → /blog/my-post
• app/api/users/index.ts → GET /api/users
• app/api/posts/[id].ts → GET /api/posts/123

Build Pipeline

Deployment

Manic works on any Bun runtime. Choose your platform:

Vercel (Serverless Functions):

vercel

Automatic deployment on push to main.

Cloudflare (Edge Runtime):

wrangler deploy

Ultra-low latency via Cloudflare Workers.

Self-Hosted (Any Bun server):

bun start

Full Bun HTTP server. Deploy anywhere with bun run.

Have questions? Check the troubleshooting or CLI Reference guide.