create-buntime

create-buntime-app

The fastest way to create a Next.js app with Bun Runtime on Vercel.

Why Bun Runtime on Vercel?

• ⚡ Faster execution - Generally faster than Node.js, especially for CPU-bound tasks
• 🎯 Zero-config TypeScript - Built-in TypeScript and JSX support out of the box
• 📦 All-in-one toolkit - Includes bundler, test runner, and package manager
• 🚀 Vercel optimized - Runs on Fluid compute with full serverless support
• 🔋 Modern by default - Latest JavaScript features with no additional setup
• 🦊 Pure Bun - Uses Bun's native APIs exclusively, no Node.js dependencies

Quick Start

# Interactive mode (will prompt for project name)
bun create buntime-app

# With a project name
bun create buntime-app my-app

# In current directory (must be empty)
bun create buntime-app .

Then:

cd my-app  # Skip if you used "."
bun install
cp .env.example .env
# Add your POSTGRES_URL to .env
bun run dev

Open http://localhost:3000 🎉

What's Included

• Next.js 16 with App Router
• Bun Runtime configured for Vercel (bunVersion: "1.x")
• PostgreSQL with Bun's native bun:sql adapter (pooling url recommended)
• Tailwind CSS v4 - Modern utility-first styling
• TypeScript - Strict mode enabled
• Biome + Ultracite - Fast formatting and linting

API Examples

The template includes working database examples:

• GET /api/db-check - Test database connection
• GET /api/db-read - Read from PostgreSQL
• POST /api/db-write - Write to PostgreSQL

All using Bun's native bun:sql for high-performance database queries.

Deploy to Vercel

# Install Vercel CLI (recommended but can also use bunx vercel)
bun add -g vercel

# Link to a new project
vercel link

# Add your environment variable
vercel env add POSTGRES_URL

# Deploy
vercel deploy

Your app automatically uses Bun runtime on Vercel (configured in vercel.json).

Requirements

• Bun v1.0.0+
• PostgreSQL database (for the included examples)

Learn More

• Bun Runtime on Vercel
• Bun Documentation
• Next.js Documentation

License

MIT