nxt-gen-cli

---

Overview

nxt-gen-cli is a powerful command-line tool designed to streamline the creation of Next.js applications. It automates the configuration of essential tools and libraries, allowing you to focus on building features, not configuration.

Whether you need a full-stack application with Prisma and Auth.js, or a lightweight frontend with Shadcn UI, nxt-gen-cli has you covered.

Installation

Run directly with npx to always use the latest version (Recommended):

``bash
npx nxt-gen-cli@latest
`

Or install globally:

`bash
npm install -g nxt-gen-cli
`

Quick Start

$3

Simply run the command and follow the prompts:

`bash
npx nxt-gen-cli
`

You will be guided to select your preferred tools:
- ORM: Prisma, Drizzle, or None
- UI Library: Shadcn UI, HeroUI, Both, or None
- Authentication: NextAuth.js (Auth.js), Clerk, or None
- State Management: React Query, Axios
- Validation: Zod + React Hook Form
- Testing: Vitest, Playwright
- Extras: Docker, Storybook, i18n, etc.

$3

For power users, skip the prompts by passing flags directly:

`bash


Create a full-stack app with pnpm

npx nxt-gen-cli my-app --pm pnpm --orm prisma --ui shadcn --auth next-auth --react-query

Create a minimal API service with yarn

npx nxt-gen-cli api-service --pm yarn --orm drizzle --docker --ci

Create a project with bun

npx nxt-gen-cli my-bun-app --pm bun --ui shadcn --react-query
`

Features

$3

| Feature | Description |
| ----------- | ------------------------------------------------------ |
| Prisma | Full Prisma ORM setup with schema template and client. |
| Drizzle | Lightweight, type-safe SQL ORM with Drizzle Kit. |

$3

| Feature | Description |
| ----------------- | ----------------------------------------------------- |
| Shadcn UI | Beautiful, accessible components built with Radix UI. |
| HeroUI | Modern, fast, and accessible UI library. |
| Framer Motion | Production-ready animation library for React. |
| Lucide React | Clean, consistent, and tree-shakable icons. |

$3

| Feature | Description |
| --------------- | --------------------------------------------- |
| NextAuth.js | Complete authentication solution for Next.js. |
| Clerk | Complete user management and authentication. |

$3

| Feature | Description |
| --------------- | ------------------------------------------------------ |
| React Query | Powerful asynchronous state management. |
| Axios | Promise based HTTP client for the browser and node.js. |
| Forms | Integrated React Hook Form + Zod validation. |
| i18n | Internationalization support with next-intl. |

$3

| Feature | Description |
| ----------- | ----------------------------------------------------- |
| Testing | Vitest for unit tests, Playwright for E2E. |
| CI/CD | GitHub Actions workflows for build and lint. |
| Docker | Containerization with standardized Dockerfile. |
| Husky | Git hooks for pre-commit linting and commit messages. |

CLI Options

`text
Usage: nxt-gen-cli [name] [options]

Arguments:
name Project name (prompted if not provided)

Options:
--pm Package Manager: npm, pnpm, yarn, bun
--orm ORM: prisma, drizzle, none
--auth Auth Provider: next-auth, clerk, none
--ui UI Library: shadcn, heroui, both, none
--react-query Install React Query (TanStack Query)
--axios Install Axios HTTP client
--forms Add Forms (RHF + Zod)
--intl Add Internationalization (next-intl)
--docker Add Docker Support
--ci Add CI/CD (GitHub Actions)
--husky Add Husky & Lint-staged
--vitest Add Vitest
--playwright Add Playwright
--storybook Add Storybook
--framer-motion Install Framer Motion
--lucide Install Lucide React icons
--examples Examples: crud, auth, both, none
--license License: MIT, Apache, none
--no-install Skip dependency installation
-h, --help Display help information
`

Project Structure

`bash
my-project/
├── .github/
│ └── workflows/
│ └── ci.yml # if --ci
├── .husky/ # if --husky
├── e2e/
│ └── example.spec.ts # if --playwright
├── messages/
│ └── en.json # if --intl
├── prisma/
│ └── schema.prisma # if --orm prisma
├── public/
├── src/
│ ├── app/
│ │ ├── api/
│ │ │ ├── auth/ # if --auth next-auth
│ │ │ └── posts/ # if --examples crud
│ │ ├── auth/ # if --examples auth
│ │ ├── posts/ # if --examples crud
│ │ ├── layout.tsx
│ │ └── page.tsx
│ ├── components/
│ │ ├── examples/ # if --forms
│ │ ├── providers/
│ │ │ └── query-provider.tsx # if --react-query
│ │ └── providers.tsx
│ ├── db/
│ │ └── schema.ts # if --orm drizzle
│ ├── lib/
│ │ ├── auth.ts # if --auth next-auth
│ │ ├── axios.ts # if --axios
│ │ ├── db.ts # if --orm drizzle
│ │ ├── prisma.ts # if --orm prisma
│ │ ├── schemas.ts # if --forms
│ │ └── utils.ts # if --ui shadcn
│ ├── i18n.ts # if --intl
│ └── middleware.ts # if --auth clerk OR --intl
├── .dockerignore # if --docker
├── .env
├── Dockerfile # if --docker
├── drizzle.config.ts # if --orm drizzle
├── next.config.mjs
├── package.json
├── playwright.config.ts # if --playwright
├── prisma.config.ts # if --orm prisma
├── tailwind.config.ts
├── tsconfig.json
└── vitest.config.ts # if --vitest
`

Contributing

Contributions are welcome! Please open an issue to discuss proposed changes before submitting a pull request.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE.md` for more information.

Author

Praboth Charith
- Website: praboth.me
- GitHub: @PrabothCharith