nexcl

Next.js CLI with built-in admin panel — Scaffold production-ready Next.js apps with an optional /ctrl admin system in seconds.

Features

• Next.js scaffolding — Creates apps with TypeScript, App Router, ESLint, and src/ directory
• Optional /ctrl admin panel — Dashboard, Pages, Users, and Settings sections out of the box
• Route protection — Middleware for /ctrl routes (ready for your auth logic)
• Extra dependencies — Pre-installs axios and zustand for common use cases
• Interactive prompts — Simple CLI flow to configure your project

Installation

# npm
npm install -g @khalisoft/nexcl

# pnpm
pnpm add -g @khalisoft/nexcl

# yarn
yarn global add @khalisoft/nexcl

Usage

nexcl [project-name]

If you omit the project name, you'll be prompted to enter one.

Example

nexcl my-app

You'll be asked:

1. Project name — Defaults to my-app or the name you passed
2. Include /ctrl admin panel? — yes (default) or no

Then run your app:

cd my-app && npm run dev

What Gets Created

Base Next.js app

• TypeScript
• App Router
• ESLint
• src/ directory
• Import alias @/*

With /ctrl admin (optional)

• Layout — Sidebar navigation (Dashboard, Pages, Users, Settings)
• Routes — /ctrl, /ctrl/pages, /ctrl/users, /ctrl/settings
• Middleware — Placeholder for admin route protection

Extra packages

• axios — HTTP client
• zustand — State management

Project Structure (with /ctrl)

my-app/
├── app/
│   ├── ctrl/
│   │   ├── layout.tsx
│   │   ├── page.tsx
│   │   ├── pages/page.tsx
│   │   ├── users/page.tsx
│   │   └── settings/page.tsx
│   └── ...
├── src/
│   └── middleware.ts
└── ...

Development

For contributors who want to run the CLI from source:

# Clone the repo
git clone https://github.com/khalisoft/nexcl.git
cd nexcl

# Install dependencies
pnpm install

# Run in dev mode (no build)
pnpm dev

# Build for release
pnpm build

Contributing

Contributions are welcome. Please open an issue or submit a pull request.

License

MIT © Devkaahl