@revealui/cli

The official CLI for creating RevealUI projects with a single command.

Usage

pnpm create revealui@latest

or with specific options:

pnpm create revealui@latest my-project --template basic-blog

Features

• Interactive project setup with guided prompts
• Multiple templates: basic-blog, e-commerce, portfolio, starter-native (Vite + @revealui/router, no Next.js)
• Automatic environment configuration
• Database setup (NeonDB, Supabase, or local PostgreSQL)
• Storage setup (Vercel Blob or Supabase)
• Payment setup (Stripe)
• Dev Container and Devbox configuration
• Git initialization with initial commit

Options

Usage: create-revealui [options] [project-name]

Options:
  -t, --template <name>   Template to use (basic-blog, e-commerce, portfolio, starter-native)
  --skip-git              Skip git initialization
  --skip-install          Skip dependency installation
  -h, --help             Display help for command

Templates

| Template | Stack | Best for | |---|---|---| | basic-blog | Next.js 16 + @revealui/* | Blogs, content sites — Next.js ecosystem | | e-commerce | Next.js 16 + @revealui/* + Stripe | Online stores with checkout | | portfolio | Next.js 16 + @revealui/* | Personal portfolio sites | | starter-native | Vite + @revealui/router + @revealui/* | RevealUI-native runtime — no Next.js dep. Best when you want to dogfood the full RevealUI stack. |

Requirements

• Node.js 24.13.0 or higher
• pnpm 10.28.2 or higher

What Gets Created

my-project/
├── apps/
│   ├── cms/              # CMS application
│   └── mainframe/        # Frontend application
├── packages/
│   └── ...               # Shared packages
├── .devcontainer/        # Dev Container configuration
├── devbox.json           # Devbox configuration
├── .env.development.local # Environment variables
└── README.md             # Project documentation

Next Steps

After creating your project:

cd my-project
pnpm dev

Visit http://localhost:4000 to access the CMS.

Development Environments

Dev Containers

Open in VS Code and select "Reopen in Container" or use GitHub Codespaces.

Devbox

devbox shell
pnpm dev

When to Use This

• You're starting a new RevealUI project from scratch and want a guided setup
• You need database, storage, and payment providers configured in one step
• You want Dev Container or Devbox configuration generated automatically
• Not for adding RevealUI to an existing project - install individual packages instead

Design Principles

• Justifiable: Every prompt earns its place - template, database, storage, and payment choices all map to real config decisions
• Adaptive: Multiple templates (blog, e-commerce, portfolio) and environment options (DevContainer, Devbox) adapt to your workflow
• Sovereign: Scaffolds a self-contained project you fully own - no hosted dependency or account required

License

MIT