|
1 | 1 | # create-next-quick |
2 | 2 |
|
3 | | -**create-next-quick** is a CLI tool that lets you instantly create a new Next.js project with your choice of options. |
| 3 | +⚡ **Fast Next.js project scaffolding with interactive setup** |
| 4 | + |
| 5 | +A lightweight CLI tool that creates Next.js projects with your preferred configuration - TypeScript, Tailwind CSS, ORMs, linters, and more. |
4 | 6 |
|
5 | 7 | 📖 **[View Documentation](https://gaureshpai.github.io/create-next-quick/)** | 🚀 **[Quick Start](#installation)** |
6 | 8 |
|
7 | | -## Why create-next-quick? |
| 9 | +--- |
| 10 | + |
| 11 | +## ✨ Why choose create-next-quick? |
8 | 12 |
|
9 | | -`create-next-quick` is a lightweight and fast alternative to `create-next-app`. It provides an interactive setup process that lets you choose the options you want for your project, such as TypeScript, Tailwind CSS, and the Next.js app directory. It also lets you create multiple pages at once, which can save you a lot of time when starting a new project. |
| 13 | +- **🚀 Faster setup** - Skip repetitive configuration steps |
| 14 | +- **🎯 Interactive prompts** - Choose exactly what you need |
| 15 | +- **📄 Multiple pages** - Generate several pages at once |
| 16 | +- **🔧 Modern tools** - Built-in support for TypeScript, Tailwind, ORMs |
| 17 | +- **🧹 Clean output** - No unnecessary boilerplate files |
10 | 18 |
|
11 | | -## Features |
| 19 | +## 🎯 Key Features |
12 | 20 |
|
13 | | -- **CLI Argument for Project Name** — skip the project name prompt by passing the app name as a CLI argument. |
14 | | -- **Package Manager Detection** — automatically detects installed package managers (`npm`, `yarn`, `pnpm`) and only prompts with available options. |
15 | | -- **Next.js App Directory** — support for the new Next.js app directory. |
16 | | -- **Custom Page Generation** — create multiple pages at once. |
17 | | -- **Linter Support** — choose between no linter, ESLint, and Biome. |
18 | | -- **Shadcn UI** — automatically installs and configures Shadcn UI with a default style and color. |
19 | | -- **Clean Project Setup** — removes default favicon and clears public folder. |
20 | | -- **Empty Default Page** — overwrites the default `page.tsx` or `index.tsx` with an empty template. |
21 | | -- **Dynamic Metadata** — always overwrites the `layout.tsx` or `layout.jsx` with a minimal template. |
22 | | -- **Conditional API Route Deletion** — deletes the default `api/hello.js` route if using the `src` directory and not the `app` directory. |
23 | | -- **Safe Project Creation** — checks if the current directory is empty when creating a project in the current directory (`.`) and prevents accidental overwrites. |
24 | | -- **ORM Support** — choose between no ORM, Prisma, and Drizzle. |
25 | | -- **Automated CI/CD Feedback** — Pull Requests now receive automated comments on test status. |
| 21 | +| Feature | Description | |
| 22 | +|---------|-------------| |
| 23 | +| **Smart Project Names** | Pass project name as argument to skip prompts | |
| 24 | +| **Package Manager Detection** | Auto-detects npm, yarn, pnpm | |
| 25 | +| **Modern Next.js** | App directory, TypeScript, Tailwind CSS | |
| 26 | +| **Multiple Pages** | Generate several pages in one go | |
| 27 | +| **Linting Options** | ESLint, Biome, or none | |
| 28 | +| **Database Ready** | Prisma, Drizzle ORM integration | |
| 29 | +| **UI Components** | Shadcn UI with auto-configuration | |
| 30 | +| **Clean Setup** | No unnecessary files or boilerplate | |
| 31 | +| **Safe Creation** | Prevents accidental overwrites | |
26 | 32 |
|
27 | 33 | ## Installation |
28 | 34 |
|
@@ -121,12 +127,17 @@ To run the tests: |
121 | 127 | To work with the documentation locally: |
122 | 128 |
|
123 | 129 | ```bash |
124 | | -# Serve docs locally (requires Python) |
| 130 | +```bash |
| 131 | +# Install dependencies first |
| 132 | +npm install |
| 133 | + |
| 134 | +# Serve documentation locally (uses http-server) |
125 | 135 | npm run docs:serve |
126 | 136 |
|
127 | | -# Open documentation website |
| 137 | +# Open documentation in browser |
128 | 138 | npm run docs:open |
129 | 139 | ``` |
| 140 | +``` |
130 | 141 |
|
131 | 142 | The documentation is automatically deployed to GitHub Pages when changes are pushed to the main branch. |
132 | 143 |
|
|
0 commit comments