@nimbuslab/cli

> Modern Next.js project generator with AI-friendly documentation and best practices built-in.

Create production-ready Next.js projects in seconds with intelligent setup, optimized documentation for AI coding assistants, and interactive service configuration.

Features

✨ Modern Stack - Next.js 16, React 19, TypeScript, Tailwind CSS 4, shadcn/ui
🤖 AI-Friendly Documentation - Auto-generated context files for Claude Code, Cursor, GitHub Copilot
⚡ Interactive Setup - Configure services (email, analytics) during project creation
📦 Zero Config - Smart defaults, production-ready from day one
🎨 Beautiful UI - shadcn/ui components with dark mode support

Quick Start

``bash
npm install -g @nimbuslab/cli
nimbus create my-project
`

Templates

$3

Perfect for marketing sites, product launches, and portfolios.

`bash
nimbus create my-site --landing
`

Includes:
- Next.js 16 (App Router, Turbopack)
- React 19 (Server Components)
- Tailwind CSS 4 (CSS-first)
- shadcn/ui (default style)
- TypeScript (strict mode)
- Responsive design
- Dark mode support
- SEO optimized

$3

Full-stack app with authentication and database.

`bash
nimbus create my-app --app
`

Everything in Landing, plus:
- Better Auth (authentication)
- Drizzle ORM (database)
- Protected routes
- User management
- Dashboard layout
- Docker support

$3

Turborepo setup for multi-app projects.

`bash
nimbus create my-workspace --turborepo
`

Includes:
- Turborepo (build system)
- Shared packages (ui, config, utils)
- Multiple apps support
- Optimized caching
- Parallel execution

AI-Friendly Documentation

Every project includes automatically generated documentation optimized for LLMs:

$3

- AGENTS.md - Universal context for Claude Code, Cursor, GitHub Copilot
- llms.txt - 2026 standard for LLM indexing (ChatGPT, Perplexity)
- ARCHITECTURE.md - Architectural decisions with rationale
- EXAMPLES.md - Common tasks with complete code examples
- Compatibility symlinks - .cursorrules, .github/copilot-instructions.md

$3

Configure integrations during project creation:

- Resend - Transactional email (3,000 emails/month free)
- Google Analytics - Site metrics (free)

The CLI provides:
- Pricing information and signup links
- API key validation
- Automatic .env and .env.example generation
- Direct links to documentation

Based on GEO (Generative Engine Optimization) best practices.

Commands

`bash
nimbus create [name] # Create new project (interactive)
nimbus analyze [dir] # Analyze existing project stack
nimbus upgrade [target] # Plan dependency upgrades
nimbus update # Update CLI itself
nimbus setup node # Configure Node.js environment (Volta)
nimbus help # Show help
`

Options

| Flag | Description |
|------|-------------|
| -y, --yes | Accept defaults (skip prompts) |
| --no-git | Skip Git initialization |
| --no-install | Skip dependency installation |
| --landing | Use landing page template |
| --app | Use web app template |
| --turborepo | Use monorepo template |

Examples

$3

`bash
nimbus create portfolio --landing -y
cd portfolio
bun dev
`

$3

`bash
nimbus create dashboard --app


Follow prompts for service configuration


cd dashboard
bun setup # Database setup
bun dev
`

$3

`bash
nimbus analyze ./my-project
nimbus analyze --json # JSON output
`

$3

`bash
nimbus upgrade --plan # Show available upgrades
nimbus upgrade tailwind # Upgrade specific package
nimbus upgrade next # Upgrade Next.js
`

Node.js Setup (Volta)

Configure Node.js environment using Volta.

Why Volta?
- No shell cache issues (unlike fnm/nvm)
- Native binaries for better performance
- Cross-platform (Linux, macOS, Windows)
- Automatic version management per project

`bash


Check current environment

nimbus setup node --check

Migrate to Volta (interactive)

nimbus setup node
`

The command will:
1. Detect existing fnm/nvm installations
2. Remove them automatically
3. Install Volta
4. Reinstall global packages

Requirements

- Bun >= 1.0

`bash


Linux/macOS

curl -fsSL https://bun.sh/install | bash

Windows

powershell -c "irm bun.sh/install.ps1 | iex"
``

Open Source Templates

- create-next-landing - Landing page template
- create-next-app - Web app template
- create-turborepo - Monorepo template

Why nimbuslab CLI?

Modern Stack
Built with the latest technologies: Next.js 16, React 19, Tailwind CSS 4. Always up-to-date.

AI-First
Documentation designed for AI coding assistants. Get better suggestions, faster onboarding.

Zero Config
Smart defaults based on industry best practices. Production-ready from day one.

Interactive
Guided setup for services and integrations. No more reading docs to get started.

Open Source
All templates are open source. Fork, customize, contribute back.

Support

- 📖 Documentation
- 🐛 Issues
- 💬 Discussions

License

MIT © nimbuslab

---

Created by nimbuslab - Building digital products with design and technology.