create-jakestack

A CLI tool to scaffold modern full-stack applications with Bun, Elysia, React, and PostgreSQL.

Quick Start

npx create-jakestack my-app
cd my-app
docker compose up -d
bun install
bun run dev

Tech Stack

Generated projects include:

Layer	Technology
Runtime	Bun
Backend	Elysia
Frontend	Vite + React + Tailwind CSS
Database	PostgreSQL + Drizzle ORM
API Docs	Swagger UI + Redoc
Monitoring	BetterStack heartbeat integration

Generated Project Structure

my-app/
├── client/                     # React frontend
│   ├── src/
│   │   ├── components/
│   │   │   ├── Layout.tsx      # Main layout with sidebar
│   │   │   └── Sidebar.tsx     # Navigation sidebar
│   │   ├── pages/
│   │   │   ├── Dashboard.tsx   # Home dashboard
│   │   │   ├── Users.tsx       # Users management
│   │   │   ├── Posts.tsx       # Posts/content
│   │   │   └── Settings.tsx    # App settings
│   │   ├── App.tsx             # Router setup
│   │   ├── main.tsx            # Entry point
│   │   └── index.css           # Tailwind styles
│   ├── index.html
│   ├── vite.config.ts
│   └── tailwind.config.js
├── server/                     # Elysia backend
│   ├── index.ts                # Server entry point
│   ├── routes/
│   │   └── health.ts           # Health check endpoint
│   └── db/
│       ├── index.ts            # Drizzle ORM instance
│       └── schema.ts           # Database schema
├── docs/
│   └── index.html              # Redoc API documentation
├── docker-compose.yml          # PostgreSQL container
├── drizzle.config.ts           # Drizzle configuration
├── .env.example                # Environment template
├── package.json
└── README.md

Features

Backend

• Elysia server with CORS and request logging
• Auto-generated OpenAPI/Swagger documentation
• PostgreSQL with Drizzle ORM (type-safe queries)
• Health check endpoint for uptime monitoring
• BetterStack heartbeat integration

Frontend

• Vite for fast development and optimized builds
• React 18 with TypeScript
• Tailwind CSS for styling
• React Router for client-side navigation
• Pre-built dashboard layout with sidebar
• Dark theme UI components

Developer Experience

• Hot reload for both frontend and backend
• Drizzle Studio for database GUI
• Type-safe database schema
• API documentation at /api/docs and /api/swagger

Available Scripts

After creating a project:

Script	Description
bun run dev	Start backend with hot reload
bun run dev:client	Start Vite dev server
bun run dev:all	Start both backend and frontend
bun run build	Build frontend for production
bun run start	Start production server
bun run db:push	Push schema changes to database
bun run db:generate	Generate SQL migration files
bun run db:migrate	Run migrations
bun run db:studio	Open Drizzle Studio GUI

URLs

URL	Description
http://localhost:3000	Application
http://localhost:5173	Vite dev server (development)
http://localhost:3000/api	API root
http://localhost:3000/api/docs	Redoc documentation
http://localhost:3000/api/swagger	Swagger UI
http://localhost:3000/api/health	Health check endpoint

Development

Prerequisites

• Bun v1.0+
• Docker (for PostgreSQL)

Building the CLI

# Install dependencies
bun install

# Build
bun run build

# Test locally
bun src/index.ts my-test-app

Publishing

npm publish

License

MIT