@ninna-ui/cli
v0.3.0
Published
CLI tool for scaffolding Ninna UI projects — Vite + React, Next.js 15, React Router v7 templates with 5 theme presets. Tailwind CSS v4.
Maintainers
Readme
@ninna-ui/cli
CLI tool for scaffolding Ninna UI projects — choose your framework, pick a theme, and start building in seconds.
📖 Full Documentation → | 📦 npm → | 🐙 GitHub →
The official CLI for Ninna UI. Scaffold a new project with your preferred framework and theme preset — fully configured with Tailwind CSS v4, TypeScript, and all Ninna UI packages.
Usage
npx @ninna-ui/cli init my-appThe interactive prompt will ask you to choose:
- Template — Vite + React, Next.js 15, or React Router v7
- Theme preset — Default (Purple), Ocean (Blue), Sunset (Orange), Forest (Green), or Minimal (Monochrome)
Options
npx @ninna-ui/cli init [name] [options]
Options:
-t, --template <template> Template: vite-react, nextjs, react-router
--preset <preset> Theme: default, ocean, sunset, forest, minimal
--skip-install Skip dependency installationExamples
# Interactive mode
npx @ninna-ui/cli init my-app
# Fully specified
npx @ninna-ui/cli init my-app -t nextjs --preset ocean
# Skip install for CI
npx @ninna-ui/cli init my-app -t vite-react --skip-installTemplates
| Template | Framework | Bundler | CSS Plugin |
|----------|-----------|---------|------------|
| vite-react | React 19 + TypeScript | Vite 7 | @tailwindcss/vite |
| nextjs | Next.js 15 App Router | Webpack/Turbopack | @tailwindcss/postcss |
| react-router | React Router v7 + TypeScript | Vite 7 | @tailwindcss/vite |
Every template includes:
- All Ninna UI packages pre-installed
- Theme preset configured in CSS
- Demo page with Button, Heading, Text, Badge, Alert, Input, Field, VStack, HStack
- TypeScript strict mode
- Ready for production
Theme Presets
| Preset | Colors | Character |
|--------|--------|-----------|
| default | Purple / Magenta | Vibrant, electric |
| ocean | Blue / Cyan | Cool, professional |
| sunset | Orange / Rose | Warm, bold |
| forest | Green / Amber | Natural, earthy |
| minimal | Monochrome | Clean, understated |
Related Packages
@ninna-ui/core— Design tokens and theme presets- All packages — Complete package list
- Starter templates — Template source code
