@ninna-ui/cli
v0.6.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
Zero-config project scaffolding for Ninna UI - choose your framework (Vite, Next.js, React Router v7, or Astro), pick a theme preset, and get a production-ready React app in seconds. TypeScript strict, Tailwind CSS v4, all 69 components pre-installed.
📖 Full Documentation → | 📦 npm → | 🐙 GitHub →
The official CLI for Ninna UI. Scaffold a production-ready project with your preferred framework and theme preset - fully configured with Tailwind CSS v4, TypeScript strict mode, and all Ninna UI component packages pre-installed. No manual setup required.
Usage
npx @ninna-ui/cli init my-appThe interactive prompt will ask you to choose:
- Template - Vite + React, Next.js 15, React Router v7, or Astro
- 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, astro
--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 |
| astro | Astro 5 + React 19 + 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
