create-aliuq

Interactive project scaffolding CLI powered by @clack/prompts.

Usage

npm create aliuq@latest [project-name]

Options:
  -n, --dry-run        Simulate without writing files
  -v, --verbose        Print detailed file output
  -l, --locale <lang>  Override locale (en / zh)
  -V, --version        Print version
  -h, --help           Show help

Templates

web-shadcn

Vue 3 + Vite + Tailwind CSS v4 + shadcn-vue

| Prompt | Options | |--------|---------| | Package manager | bun / pnpm / npm / yarn | | Linter | Biome / ESLint + @antfu/eslint-config / oxlint + oxfmt | | Git hooks | simple-git-hooks + lint-staged (optional) | | Install all shadcn components | yes / no | | aliuq registry | add custom shadcn-vue registry (optional) |

devcontainer

Generates .devcontainer/devcontainer.json.

| Prompt | Options | |--------|---------| | Registry | ghcr.io / Docker Hub / Aliyun / custom | | Tag | me / base / alpine / debian (or custom image) | | Forwarded ports | comma-separated list | | postCreateCommand | shell command after container creation |

Development

npm install
npm run dev    # watch mode (tsdown --watch)
npm run build  # build to dist/

Adding a Template

1. Create a class extending BaseTemplate in src/templates/
2. Add Handlebars template files under templates/<name>/
3. Register it in src/templates/index.ts