{"id":34767581,"url":"https://github.com/prabothcharith/nxt-gen-cli","last_synced_at":"2026-02-05T04:05:16.392Z","repository":{"id":328740611,"uuid":"1112934867","full_name":"PrabothCharith/nxt-gen-cli","owner":"PrabothCharith","description":"The ultimate Next.js scaffold CLI generator. Customize your stack with Prisma, React Query, Shadcn, HeroUI, and more in seconds.","archived":false,"fork":false,"pushed_at":"2026-01-15T15:32:15.000Z","size":150,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-15T19:12:42.162Z","etag":null,"topics":["cli","drizzle","generator","heroui","nextjs","orm","prisma","react-query","scaffold","shadcn","template"],"latest_commit_sha":null,"homepage":"https://praboth.me/nxt-gen-cli","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PrabothCharith.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-09T09:51:50.000Z","updated_at":"2026-01-15T15:31:57.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/PrabothCharith/nxt-gen-cli","commit_stats":null,"previous_names":["prabothcharith/nextjs-template-nxt-gen-cli"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/PrabothCharith/nxt-gen-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PrabothCharith%2Fnxt-gen-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PrabothCharith%2Fnxt-gen-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PrabothCharith%2Fnxt-gen-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PrabothCharith%2Fnxt-gen-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PrabothCharith","download_url":"https://codeload.github.com/PrabothCharith/nxt-gen-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PrabothCharith%2Fnxt-gen-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28601284,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T09:39:28.479Z","status":"ssl_error","status_checked_at":"2026-01-20T09:38:10.511Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","drizzle","generator","heroui","nextjs","orm","prisma","react-query","scaffold","shadcn","template"],"created_at":"2025-12-25T07:43:30.279Z","updated_at":"2026-01-20T10:01:19.434Z","avatar_url":"https://github.com/PrabothCharith.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# nxt-gen-cli\n\n\u003cdiv align=\"center\"\u003e\n\n![npm](https://img.shields.io/npm/v/nxt-gen-cli?style=flat-square\u0026color=000000)\n![license](https://img.shields.io/npm/l/nxt-gen-cli?style=flat-square\u0026color=000000)\n![downloads](https://img.shields.io/npm/dt/nxt-gen-cli?style=flat-square\u0026color=000000)\n![stars](https://img.shields.io/github/stars/PrabothCharith/nxt-gen-cli?style=flat-square\u0026color=000000)\n\n\u003cbr /\u003e\n\n\u003ch1\u003eThe Ultimate Next.js Scaffold CLI\u003c/h1\u003e\n\n\u003cp\u003e\n  \u003cb\u003eSkip the repetitive setup. Build your dream stack in seconds.\u003c/b\u003e\n\u003c/p\u003e\n\n[Website](https://praboth.me/nxt-gen-cli) • [Report Bug](https://github.com/PrabothCharith/nxt-gen-cli/issues) • [Request Feature](https://github.com/PrabothCharith/nxt-gen-cli/issues)\n\n\u003c/div\u003e\n\n---\n\n## Overview\n\n**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.\n\nWhether you need a full-stack application with **Prisma** and **Auth.js**, or a lightweight frontend with **Shadcn UI**, nxt-gen-cli has you covered.\n\n## Installation\n\nRun directly with `npx` to always use the latest version (Recommended):\n\n```bash\nnpx nxt-gen-cli@latest\n```\n\nOr install globally:\n\n```bash\nnpm install -g nxt-gen-cli\n```\n\n## Quick Start\n\n### Interactive Mode\n\nSimply run the command and follow the prompts:\n\n```bash\nnpx nxt-gen-cli\n```\n\nYou will be guided to select your preferred tools:\n-   **ORM**: Prisma, Drizzle, or None\n-   **UI Library**: Shadcn UI, HeroUI, Both, or None\n-   **Authentication**: NextAuth.js (Auth.js), Clerk, or None\n-   **State Management**: React Query, Axios\n-   **Validation**: Zod + React Hook Form\n-   **Testing**: Vitest, Playwright\n-   **Extras**: Docker, Storybook, i18n, etc.\n\n### Command-Line Flags\n\nFor power users, skip the prompts by passing flags directly:\n\n```bash\n# Create a full-stack app with pnpm\nnpx nxt-gen-cli my-app --pm pnpm --orm prisma --ui shadcn --auth next-auth --react-query\n\n# Create a minimal API service with yarn\nnpx nxt-gen-cli api-service --pm yarn --orm drizzle --docker --ci\n\n# Create a project with bun\nnpx nxt-gen-cli my-bun-app --pm bun --ui shadcn --react-query\n```\n\n## Features\n\n### Database \u0026 ORM\n| Feature     | Description                                            |\n| ----------- | ------------------------------------------------------ |\n| **Prisma**  | Full Prisma ORM setup with schema template and client. |\n| **Drizzle** | Lightweight, type-safe SQL ORM with Drizzle Kit.       |\n\n### UI \u0026 Styling\n| Feature           | Description                                           |\n| ----------------- | ----------------------------------------------------- |\n| **Shadcn UI**     | Beautiful, accessible components built with Radix UI. |\n| **HeroUI**        | Modern, fast, and accessible UI library.              |\n| **Framer Motion** | Production-ready animation library for React.         |\n| **Lucide React**  | Clean, consistent, and tree-shakable icons.           |\n\n### Authentication\n| Feature         | Description                                   |\n| --------------- | --------------------------------------------- |\n| **NextAuth.js** | Complete authentication solution for Next.js. |\n| **Clerk**       | Complete user management and authentication.  |\n\n### Core \u0026 Infrastructure\n| Feature         | Description                                            |\n| --------------- | ------------------------------------------------------ |\n| **React Query** | Powerful asynchronous state management.                |\n| **Axios**       | Promise based HTTP client for the browser and node.js. |\n| **Forms**       | Integrated React Hook Form + Zod validation.           |\n| **i18n**        | Internationalization support with `next-intl`.         |\n\n### Quality \u0026 DevOps\n| Feature     | Description                                           |\n| ----------- | ----------------------------------------------------- |\n| **Testing** | Vitest for unit tests, Playwright for E2E.            |\n| **CI/CD**   | GitHub Actions workflows for build and lint.          |\n| **Docker**  | Containerization with standardized Dockerfile.        |\n| **Husky**   | Git hooks for pre-commit linting and commit messages. |\n\n## CLI Options\n\n```text\nUsage: nxt-gen-cli [name] [options]\n\nArguments:\n  name                    Project name (prompted if not provided)\n\nOptions:\n  --pm \u003ctype\u003e             Package Manager: npm, pnpm, yarn, bun\n  --orm \u003ctype\u003e            ORM: prisma, drizzle, none\n  --auth \u003ctype\u003e           Auth Provider: next-auth, clerk, none\n  --ui \u003ctype\u003e             UI Library: shadcn, heroui, both, none\n  --react-query           Install React Query (TanStack Query)\n  --axios                 Install Axios HTTP client\n  --forms                 Add Forms (RHF + Zod)\n  --intl                  Add Internationalization (next-intl)\n  --docker                Add Docker Support\n  --ci                    Add CI/CD (GitHub Actions)\n  --husky                 Add Husky \u0026 Lint-staged\n  --vitest                Add Vitest\n  --playwright            Add Playwright\n  --storybook             Add Storybook\n  --framer-motion         Install Framer Motion\n  --lucide                Install Lucide React icons\n  --examples \u003ctype\u003e       Examples: crud, auth, both, none\n  --license \u003ctype\u003e        License: MIT, Apache, none\n  --no-install            Skip dependency installation\n  -h, --help              Display help information\n```\n\n## Project Structure\n\n```bash\nmy-project/\n├── .github/\n│   └── workflows/\n│       └── ci.yml             # if --ci\n├── .husky/                    # if --husky\n├── e2e/\n│   └── example.spec.ts        # if --playwright\n├── messages/\n│   └── en.json                # if --intl\n├── prisma/\n│   └── schema.prisma          # if --orm prisma\n├── public/\n├── src/\n│   ├── app/\n│   │   ├── api/\n│   │   │   ├── auth/          # if --auth next-auth\n│   │   │   └── posts/         # if --examples crud\n│   │   ├── auth/              # if --examples auth\n│   │   ├── posts/             # if --examples crud\n│   │   ├── layout.tsx\n│   │   └── page.tsx\n│   ├── components/\n│   │   ├── examples/          # if --forms\n│   │   ├── providers/\n│   │   │   └── query-provider.tsx # if --react-query\n│   │   └── providers.tsx\n│   ├── db/\n│   │   └── schema.ts          # if --orm drizzle\n│   ├── lib/\n│   │   ├── auth.ts            # if --auth next-auth\n│   │   ├── axios.ts           # if --axios\n│   │   ├── db.ts              # if --orm drizzle\n│   │   ├── prisma.ts          # if --orm prisma\n│   │   ├── schemas.ts         # if --forms\n│   │   └── utils.ts           # if --ui shadcn\n│   ├── i18n.ts                # if --intl\n│   └── middleware.ts          # if --auth clerk OR --intl\n├── .dockerignore              # if --docker\n├── .env\n├── Dockerfile                 # if --docker\n├── drizzle.config.ts          # if --orm drizzle\n├── next.config.mjs\n├── package.json\n├── playwright.config.ts       # if --playwright\n├── prisma.config.ts           # if --orm prisma\n├── tailwind.config.ts\n├── tsconfig.json\n└── vitest.config.ts           # if --vitest\n```\n\n## Contributing\n\nContributions are welcome! Please open an issue to discuss proposed changes before submitting a pull request.\n\n1.  Fork the repository\n2.  Create a feature branch (`git checkout -b feature/amazing-feature`)\n3.  Commit your changes (`git commit -m 'Add some amazing feature'`)\n4.  Push to the branch (`git push origin feature/amazing-feature`)\n5.  Open a Pull Request\n\n## License\n\nDistributed under the MIT License. See `LICENSE.md` for more information.\n\n## Author\n\n**Praboth Charith**\n-   Website: [praboth.me](https://praboth.me)\n-   GitHub: [@PrabothCharith](https://github.com/PrabothCharith)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprabothcharith%2Fnxt-gen-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprabothcharith%2Fnxt-gen-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprabothcharith%2Fnxt-gen-cli/lists"}