nextjs-starter-pack

📦 Quick Start

Create a new project with a single command:

npx nextjs-starter-pack

Or with customization options:

npx nextjs-starter-pack my-app --dark-mode --state zustand

✨ Features

• ⚡️ Next.js 15 (App Router)
• ⚛️ React 19
• 🔷 TypeScript
• 🎨 Tailwind CSS v4
• 💾 Prisma/Drizzle ORM
• 🔐 Auth.js / Clerk
• 🛠️ ESLint and Prettier
• 🌓 Dark Mode (next-themes)
• 🧩 Shadcn UI
• 📊 TanStack Query
• 📋 React Hook Form
• 🛡️ Zod Validation
• 🔄 Zustand / Jotai
• 🖼️ Lucide Icons
• 📦 Import Aliases

🛠️ CLI Options

| Option | Description | | ----------------------- | ------------------------------------------ | | [projectName] | Name of your project | | -d, --dark-mode | Dark mode with next-themes | | -r, --rhf | React Hook Form with Zod | | -q, --tanstack-query | TanStack Query | | -s, --state <library> | State management with zustand or jotai | | -o, --orm <library> | Querying with ORM (prisma or drizzle) | | -a, --auth <library> | Authentication with authjs or clerk | | -i, --skip-install | Skip installing dependencies |

📁 Project Structure

my-app/
├── src/
│   ├── app/           # App router (layout, routes, API)
│   ├── components/    # Reusable UI (Shadcn UI)
│   ├── actions/       # Server actions
│   ├── store/         # Zustand/Jotai
│   ├── lib/           # Helpers & utils
│   └── context/       # Context providers
├── prisma/            # DB schema & seeding
├── drizzle/           # DB migrations
└── config + setup     # ESLint, Prettier, TypeScript, etc.

🛣️ Roadmap

• [ ] 🔄 CI/CD (deployment with vercel)
• [ ] 🧪 Testing - Jest, RTL, and Cypress support
• [ ] 💳 Stripe integration
• [ ] 🌐 i18n
• [ ] 📊 Analytics
• [ ] 🔒 Security headers and best practices
• [ ] 📱 Progressive Web App capabilities
• [ ] 🎭 Storybook - Component documentation
• [ ] 📧 Email templates and sending capabilities

👥 Contributing

Contributions are welcome! Here's how you can help:

1. Fork the repository
2. Create a new branch from develop
3. Commit and push your changes to the branch
4. Open a Pull Request to develop

Please make sure to follow the existing code style of the project.

Development & Testing

For local development and testing, see the nextjs-starter-app repository - a reference implementation showcasing the output of this starter pack.