Package Exports

create-yuv-app
create-yuv-app/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (create-yuv-app) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Create YUV App

The fastest way to create production-ready Next.js applications with authentication, modern UI, and TypeScript.

⚡ Quick Start

npx create-yuv-app my-app
cd my-app
npm run dev

That's it! Your app will be running at http://localhost:3000 🚀

🎯 What You Get

⚡ Next.js 15 - Latest App Router with Turbopack
🔐 Clerk Authentication - Complete auth solution with sign-in/sign-up
🎨 Shadcn/ui - Beautiful, accessible UI components
📱 Responsive Design - Mobile-first with Tailwind CSS
🎯 TypeScript - Full type safety out of the box
🎭 Lucide Icons - Beautiful icon library
🛡️ Middleware Protection - Route-based authentication
✨ Modern Tooling - ESLint, PostCSS, and more

📋 Requirements

Node.js 18+
npm / yarn / pnpm

🛠️ Usage

Interactive Mode

npx create-yuv-app my-awesome-app

The CLI will guide you through:

✅ Project setup
✅ Dependency installation
✅ Environment file creation
✅ Git repository initialization

What Happens Next?

📦 Clones the latest boilerplate
🧹 Cleans repository history for a fresh start
📝 Creates .env.local with Clerk template
📥 Installs all dependencies
🔗 Initializes new git repository
✅ Ready to start coding!

🔑 Setting Up Clerk Auth

Visit Clerk.com and create an account
Create a new application
Copy your keys to .env.local:

NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_...
CLERK_SECRET_KEY=sk_test_...

Start coding! 🎉

🏗️ Project Structure

my-app/
├── src/
│   ├── app/                    # Next.js App Router
│   │   ├── dashboard/          # Protected dashboard
│   │   ├── sign-in/           # Auth pages
│   │   ├── sign-up/           
│   │   ├── globals.css        
│   │   ├── layout.tsx         
│   │   └── page.tsx           # Landing page
│   ├── components/            # React components
│   │   ├── ui/               # Shadcn/ui components
│   │   └── *.tsx             # Custom components
│   ├── lib/
│   │   └── utils.ts          
│   └── middleware.ts         # Auth protection
├── public/                   # Static assets
├── .env.local               # Environment variables
└── package.json

🎨 Available Components

Pre-installed Shadcn/ui components:

Avatar, Badge, Button, Card
Dialog, Dropdown Menu, Input, Label
Navigation Menu, Separator

Add more with: npx shadcn@latest add [component-name]

📖 Commands

After creating your app:

# Development
npm run dev          # Start dev server with Turbopack

# Production
npm run build        # Build for production
npm start           # Start production server

# Code Quality
npm run lint        # Run ESLint

🚀 Deployment

Vercel (Recommended)

git push to GitHub
Connect to Vercel
Add Clerk environment variables
Deploy! 🎉

Other Platforms

npm run build
npm start

💡 Examples

# Create app with custom name
npx create-yuv-app "My Startup MVP"

# Create in current directory
npx create-yuv-app .

🤝 Contributing

Found a bug or want to contribute?

Fork the repo
Create your feature branch
Submit a pull request

📄 License

MIT License - feel free to use for personal and commercial projects.

🙏 Credits

Created with ❤️ by Yuval Avidani, Founder of YUV.AI

Connect:

🐦 Twitter: @yuvalav
📸 Instagram: @yuval_770
🔗 Links: linktr.ee/yuvai
🌐 Website: yuv.ai

⭐ Star the repo if this helped you build something awesome!

🆘 Support

Need help?

Happy coding! 🚀