create-yuv-bun-app

🚀 Create a production-ready Next.js + Bun app in seconds

Get started with the ultimate Next.js boilerplate featuring Bun, Shadcn/ui, Tailwind CSS, and Google Authentication - all set up with one command.

View Template • Report Issue • npm Package

⚡ Quick Start

Installation

Create a new project with one command:

With Bun (Recommended - 30x faster)

bun create yuv-bun-app my-project

With npm

npm create yuv-bun-app my-project

With pnpm

pnpm create yuv-bun-app my-project

With Yarn

yarn create yuv-bun-app my-project

Next Steps

After installation completes:

cd my-project

Configure environment variables:

1. Copy .env.example to .env.local
2. Add your Google OAuth credentials (see setup guide)

Start development:

bun run dev

Visit http://localhost:3000 🎉

🎁 What You Get

This command sets up a complete, production-ready Next.js application with:

🚀 Core Stack

• Next.js 16 - Latest with App Router & Server Components
• Bun - 30x faster than npm, native TypeScript support
• React 19 - Latest React with concurrent features
• TypeScript 5 - Full type safety with strict mode

🎨 UI & Styling

• Shadcn/ui - Beautiful, accessible components
• Tailwind CSS 4 - Utility-first CSS with latest features
• Dark Mode - System-aware theme switching
• Lucide Icons - 1000+ beautiful icons
• Geist Font - Vercel's optimized font family

🔐 Authentication

• NextAuth.js - Complete authentication solution
• Google OAuth - Pre-configured (just add credentials)
• Protected Routes - Example implementations included
• Session Management - Server & client-side handling

🛠️ Developer Experience

• React Hook Form - Performant forms
• Zod - TypeScript-first schema validation
• Hot Reloading - Instant feedback with Turbopack
• ESLint Ready - Code quality tools configured

📦 Pre-installed Components

• Avatar
• Button
• Card
• Dropdown Menu
• Form
• Input
• Label
• Mode Toggle
• Separator

📊 Performance

| Metric | npm | Bun | Winner | |--------|-----|-----|--------| | Installation | ~45s | ~1.5s | 🏆 Bun (30x faster) | | Disk Space | ~500MB | ~200MB | 🏆 Bun (60% smaller) | | Script Execution | ~150ms | ~25ms | 🏆 Bun (6x faster) |

🎯 Perfect For

✅ SaaS applications
✅ Landing pages
✅ Web applications
✅ Portfolio sites
✅ MVP development
✅ Hackathon projects

📚 Documentation

Full Template Documentation

• Complete Documentation
• Project Structure
• Configuration Guide
• Adding Components
• Deployment Guide

Quick Commands

After creating your project:

# Development
bun run dev          # Start dev server

# Building
bun run build        # Create production build
bun run start        # Start production server

# Linting
bun run lint         # Run ESLint

# Add Shadcn components
bunx shadcn add [component-name]

🔧 Requirements

• Bun (recommended) or Node.js 18+
• Git

Install Bun

Linux/macOS:

curl -fsSL https://bun.sh/install | bash

Windows (PowerShell):

powershell -c "irm bun.sh/install.ps1 | iex"

🐛 Troubleshooting

Installation fails

# Clear cache and try again
bun pm cache rm
bun create yuv-bun-app my-project

Permission errors

# On Linux/macOS, ensure proper permissions
sudo chown -R $USER my-project

Git not found

Make sure Git is installed: https://git-scm.com/downloads

🤝 Contributing

Found a bug or have a suggestion?

• Report an issue
• View the template
• Submit a PR

📄 License

MIT © Yuval Avidani

👨‍💻 About the Creator

Yuval Avidani
AWS AI Superstar • GitHub Star • Founder of YUV.AI Community

AI Builder & Speaker with 2 decades of experience in tech

💖 Support

If this tool helped you ship faster:

• ⭐ Star the repo
• 🐛 Report issues
• 📢 Share with other developers
• ☕ Buy me a coffee

Built with ❤️ by Yuval Avidani

🤖 Powered by AI • Optimized for Developers