🚀 Next.js Fullstack Starter CLI

A custom project scaffolding CLI that bootstraps a full-featured Next.js 15 app with:

• ⚡ TypeScript + App Router + Src Dir
• 🎨 TailwindCSS + shadcn/ui components
• 🌓 Dark/Light mode via next-themes
• 📦 Prisma ORM (with singleton client setup)
• ✅ Zod validation + React Hook Form
• 🔔 Sonner for beautiful toast notifications
• 🏗️ Preconfigured folder structure (hooks, lib, providers, schemas, server, actions)

This CLI saves hours by automating the setup of a modern fullstack stack.

📖 Features

• Prompts for project name.
• Runs create-next-app with TypeScript, Tailwind, ESLint, App Router, and custom alias.
• Installs Prisma, next-themes, react-icons, shadcn/ui, sonner.
• Initializes Prisma with singleton client (src/lib/prisma.ts).
• Adds ThemeProvider (src/providers/theme-provider.tsx).
• Adds form validation schema with Zod (src/schemas/index.ts).
• Creates a sample form on src/app/page.tsx.
• Injects ThemeProvider and Sonner Toaster into layout.tsx.
• Prepares a starter project structure for scalable apps.

⚙️ Installation

Clone or copy this repo, then make the script executable:

Node:

npx next-shrey

🛠️ What It Does

1. Prompts for project name.

2. Bootstraps a Next.js app using:

   npx create-next-app@latest my-app --typescript --tailwind --eslint --app --src-dir --import-alias "@/*"

3. Installs dependencies:

   npm install next-themes react-icons
   npm install prisma --save-dev
   npm install @prisma/client

4. Initializes Prisma:

   npx prisma init

5. Sets up shadcn/ui:

   npx shadcn@latest init
   npx shadcn@latest add button form input label sonner card

6. Creates folders:

   src/
   ├── hooks
   ├── lib
   ├── providers
   ├── server
   ├── actions
   └── schemas

7. Adds ThemeProvider, Prisma Client singleton, Zod schema, and replaces the homepage with a working form.

📝 Usage

After running the CLI:

cd your-project-name
npx prisma db push   # Sync schema with your database
npm run dev          # Start development server

Then open:

👉 http://localhost:3000

You’ll see a welcome page with a working form, validation, and toast notifications.

📂 Project Structure

src/
├── actions/         # Server actions
├── app/             # Next.js app router
│   ├── layout.tsx   # Wrapped with ThemeProvider + Toaster
│   └── page.tsx     # Example form page
├── hooks/           # Custom React hooks
├── lib/             # Prisma client & utilities
│   └── prisma.ts
├── providers/       # Context providers
│   └── theme-provider.tsx
├── schemas/         # Zod validation schemas
│   └── index.ts
└── server/          # Backend logic

🎉 Example Form

• Uses React Hook Form + Zod
• Shows toast notifications with Sonner
• Example fields: username, email

🔮 Next Steps

• Add more shadcn/ui components with:

  npx shadcn@latest add [component]

• Define your Prisma schema in prisma/schema.prisma

• Run migrations:

  npx prisma migrate dev

• Extend src/schemas/ with more validation logic

• Add new pages & API routes

✅ Done!

Your Next.js fullstack app is ready in minutes.

cd my-app
npm run dev

Happy coding! 🎉