@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

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

Templates

Landing Page

Perfect for marketing sites, product launches, and portfolios.

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

Web Application

Full-stack app with authentication and database.

nimbus create my-app --app

Everything in Landing, plus:

• Better Auth (authentication)
• Drizzle ORM (database)
• Protected routes
• User management
• Dashboard layout
• Docker support

Monorepo

Turborepo setup for multi-app projects.

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:

Generated Files

• 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

Interactive Service Setup

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

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

Landing Page (Auto Mode)

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

Web App (Interactive)

nimbus create dashboard --app
# Follow prompts for service configuration
cd dashboard
bun setup  # Database setup
bun dev

Analyze Existing Project

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

Plan Upgrades

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

# 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

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