create-hua

v1.0.0-alpha.25

CLI

Scaffolding

CLI scaffolding tool for creating new hua projects. One command to get a fully configured Next.js + hua starter.

$npx create-hua my-app

주요 기능

One Command Setup

Full Next.js + hua project scaffolded in seconds with latest versions

AI Context Files

Optional .cursorrules, ai-context.md, and Claude skills for AI-assisted development

i18n Ready

Korean/English translations pre-configured with API route handler

Smart Detection

Auto-detects monorepo context, package manager, and resolves latest npm versions

빠른 시작

1. Create a new project

bash

# Interactive mode (recommended)
npx create-hua my-app

# Or with pnpm
pnpm create hua my-app

2. Start development

bash

cd my-app
pnpm install
pnpm dev

3. Non-interactive mode (CI/CD)

bash

# Use defaults: all AI files except Claude skills, both languages
NON_INTERACTIVE=1 npx create-hua my-app

# Or with flags
npx create-hua my-app --claude-skills --lang ko --install

Scaffolded Structure

text

my-app/
├── app/
│   ├── layout.tsx              # Root layout with HuaProvider
│   ├── page.tsx                # Home page
│   ├── globals.css             # Tailwind CSS
│   └── api/translations/       # i18n API route
├── components/
│   ├── LanguageToggle.tsx      # Language switcher
│   └── I18nProviderWrapper.tsx
├── lib/
│   ├── i18n-setup.ts           # i18n configuration
│   └── utils.ts
├── store/
│   └── useAppStore.ts          # Zustand store example
├── translations/
│   ├── ko/common.json          # Korean translations
│   └── en/common.json          # English translations
├── .claude/                     # Claude AI context (optional)
├── .cursorrules                 # Cursor IDE rules (optional)
├── hua.config.ts            # Framework configuration
├── next.config.ts
├── tailwind.config.js          # Auto-generated with monorepo detection
└── package.json                # Latest versions from npm

CLI Options

--claude-skills

Include .claude/skills/ directory

--no-cursorrules

Skip .cursorrules file

--no-ai-context

Skip ai-context.md file

--no-claude-context

Skip .claude/project-context.md

--lang <ko|en|both>

Set documentation language (default: both)

--dry-run

Preview project creation without writing files

--install

Auto-install dependencies after creation

Doctor Command

Validate an existing project's structure and dependencies:

bash

npx create-hua doctor ./my-app

Prerequisites

Node.js >= 22.0.0

Required for latest JavaScript features

pnpm

Recommended package manager (auto-detected)

create-hua

주요 기능

One Command Setup

AI Context Files

i18n Ready

Smart Detection

빠른 시작

1. Create a new project

2. Start development

3. Non-interactive mode (CI/CD)

Scaffolded Structure

CLI Options

Doctor Command

Prerequisites

관련 패키지