Skip to content
This repository was archived by the owner on Jul 4, 2026. It is now read-only.

Commit f2f828c

Browse files
committed
fix: Address PR feedback and improve documentation setup
Fixes #31 - Remove docs/CNAME.example (not needed for custom domain) - Replace python server with universal http-server in package.json - Add http-server as dev dependency for cross-platform compatibility - Simplify README description and structure for better readability - Fix GitHub Actions permissions for Pages deployment - Add proper token handling in workflow - Update documentation serving instructions Changes made: ✅ Universal server solution (npx http-server) ✅ Cleaner README with table format ✅ Removed unnecessary CNAME file ✅ Enhanced workflow permissions ✅ Better developer experience
1 parent b309940 commit f2f828c

5 files changed

Lines changed: 45 additions & 24 deletions

File tree

.github/workflows/deploy-docs.yml

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,13 +16,19 @@ concurrency:
1616

1717
jobs:
1818
deploy:
19+
runs-on: ubuntu-latest
20+
permissions:
21+
contents: read
22+
pages: write
23+
id-token: write
1924
environment:
2025
name: github-pages
2126
url: ${{ steps.deployment.outputs.page_url }}
22-
runs-on: ubuntu-latest
2327
steps:
2428
- name: Checkout
2529
uses: actions/checkout@v4
30+
with:
31+
token: ${{ secrets.GITHUB_TOKEN }}
2632

2733
- name: Setup Pages
2834
uses: actions/configure-pages@v4

README.md

Lines changed: 30 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,34 @@
11
# create-next-quick
22

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.
46

57
📖 **[View Documentation](https://gaureshpai.github.io/create-next-quick/)** | 🚀 **[Quick Start](#installation)**
68

7-
## Why create-next-quick?
9+
---
10+
11+
## ✨ Why choose create-next-quick?
812

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
1018

11-
## Features
19+
## 🎯 Key Features
1220

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 |
2632

2733
## Installation
2834

@@ -121,12 +127,17 @@ To run the tests:
121127
To work with the documentation locally:
122128

123129
```bash
124-
# Serve docs locally (requires Python)
130+
```bash
131+
# Install dependencies first
132+
npm install
133+
134+
# Serve documentation locally (uses http-server)
125135
npm run docs:serve
126136

127-
# Open documentation website
137+
# Open documentation in browser
128138
npm run docs:open
129139
```
140+
```
130141
131142
The documentation is automatically deployed to GitHub Pages when changes are pushed to the main branch.
132143

docs/CNAME.example

Lines changed: 0 additions & 2 deletions
This file was deleted.

docs/index.html

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,9 @@
11
<!DOCTYPE html>
2+
<!--
3+
Enhanced Documentation Site for create-next-quick
4+
Resolves: Enhanced Documentation with Copy Functionality and Improved Design
5+
Features: Interactive copy buttons, responsive design, comprehensive guides
6+
-->
27
<html lang="en">
38
<head>
49
<meta charset="UTF-8">

package.json

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313
"test": "npm run test:generate && mocha",
1414
"test:generate": "node test/generate-tests.js",
1515
"start": "node index.js",
16-
"docs:serve": "cd docs && python -m http.server 8080",
16+
"docs:serve": "npx http-server docs -p 8080",
1717
"docs:open": "open https://gaureshpai.github.io/create-next-quick/"
1818
},
1919
"bin": {
@@ -48,6 +48,7 @@
4848
},
4949
"devDependencies": {
5050
"inquirer-test": "^2.0.1",
51-
"mocha": "^11.7.3"
51+
"mocha": "^11.7.3",
52+
"http-server": "^14.1.1"
5253
}
5354
}

0 commit comments

Comments
 (0)