kudo
is a zero-config CLI tool to kickstart your Next.js apps — but with a twist of discipline. It comes pre-configured with Husky, Commitlint, Prettier, and VsCode recommended settings to help you build scalable and clean applications with a strong development workflow — right from the first commit.
- ⚡️ Create a fully set-up Next.js app in seconds
- 🧼 Enforced Prettier formatting
- 🥊 Husky hooks for pre-commit checks
- 🔍 Commitlint to ensure conventional commit messages
- 📁 Clean folder structure, ready for development
You can use npx
(recommended):
npx create-kudo-app my-next-app
Or install globally:
npm install -g create-kudo-app
create-kudo-app my-next-app
-
Next.js
(latest) -
Prettier
with sensible defaults -
Husky
for Git hooks-
pre-commit
: Lint and format staged files -
commit-msg
: Validate commit message usingcommitlint
-
-
Commitlint
with@commitlint/config-conventional
-
.vscode
folder with recommended extensions:- Prettier
- ESLint (if added later)
- Conventional Commits
-
Git initialized & first commit made
npx create-kudo-app my-app
cd my-app
npm run dev
Want to customize? Tweak the .prettierrc
, .husky/
, or .vscode/settings.json
files as needed.
If you want to develop or customize kudo
locally:
git clone https://github.com/msi404/kudo.git
cd kudo
npm install
npm run build
npm link
kudo my-next-app
This will generate a new project in the my-next-app
folder with all tooling preconfigured.
Kudo 🥋 encourages code cleanliness and consistency as part of the project’s foundation — not an afterthought. It brings discipline to your dev dojo so you can ship with confidence and pride.
Contributions are welcome! Feel free to open issues or submit PRs.
MIT © Ismail Salah
Built with honor and code discipline. 💻✨