1jm - Full-stack Framework for Bun

A lightweight full-stack framework combining React (Vite) for the frontend and Hono for the backend. Built specifically for the Bun runtime with native Vercel deployment support.

Why 1jm?

• Bun-native - Built from the ground up for Bun. Uses Bun.serve, Bun.build, and Bun's native fetch
• Type-safe RPC - Direct HTTP communication between client and server with full type inference
• Minimal Abstraction - React on the client, Hono on the server. No magic, just standard APIs
• Vercel Integration - Native Vercel Edge/Serverless output with automatic route analysis
• Static Route Caching - Experimental feature to auto-detect static endpoints and cache them at CDN edge
• Fast Builds - Bun.build for bundling, esbuild-powered Vite for development

When to Use

• You want to use Bun as your server runtime
• Building a React app with Hono API routes
• Deploying to Vercel (Edge Functions or Serverless)
• Need type-safe client-to-server communication without GraphQL/tRPC overhead
• Want hot reload for both client and server

Quick Start

# Create a new project (requires Bun)
bunx 1jm-cli
1jm create my-app

# Interactive setup will ask for:
# - Project Name
# - Database selection (Prisma available, Drizzle coming soon)
# - Styling options (Tailwind CSS, shadcn/ui)
# - Git initialization

cd my-app

# Development - starts both client (Vite) and server (Bun)
bun run dev

# Production build
bun run build

# To generate Vercel deployment artifacts
bun run build --vercel

Features & Tech Stack

• Frontend: React 19.x with TypeScript, Vite
• Backend: Hono 4.x
• Runtime: Bun (primary), Node.js compatible
• Styling Options:
  • Tailwind CSS v4
  • shadcn/ui components
• Database Support:
  • ✅ Prisma (SQLite default, easily swappable)
  • 🚧 Drizzle (Coming Soon)

Project Structure

my-app/
├── client/               # React frontend (Vite)
│   ├── index.html
│   └── src/
│       ├── main.tsx
│       └── App.tsx
├── server/               # Hono backend
│   ├── db.ts             # Database client (if selected)
│   └── index.ts          # Exports Hono app
├── prisma/               # Prisma schema (if selected)
├── package.json
└── tsconfig.json

Commands

Command	Description
1jm create <name>	Create new project (interactive if no name)
1jm dev	Start dev servers (client + server)
1jm dev --client	Client dev server only (port 3000)
1jm dev --server	Server dev server only (port 45828)
1jm build	Production build (outputs to dist/)
1jm build --vercel	Vercel build (outputs to .vercel/output/)
1jm build --vercel --experimental-static	Vercel build with static route caching
1jm analyze	Analyze routes for static/dynamic classification
1jm start	Start production server from dist/

Runtime Support

Runtime	Support
Bun	Primary - full support
Vercel Edge	Native via --vercel
Vercel Serverless	Native via --vercel
Node.js	Compatible (server exports fetch)

License

MIT