create-next-vz-app
v1.0.4
Published
Interactive CLI to scaffold a Next.js project with TypeScript, TailwindCSS, Zustand, React Hook Form, Motion, Vitest, and more.
Downloads
43
Readme
create-next-vz-app
交互式 CLI 脚手架,快速创建开箱即用的 Next.js 项目。
使用
# 交互式创建
npx create-next-vz-app my-app
# 或不指定名称,CLI 会交互询问
npx create-next-vz-app交互流程
- 项目名称 — 输入 npm 包名(小写字母、数字、连字符)
- 能力选择 — 空格选择/取消以下 7 项能力(默认全选):
- Zustand — 状态管理
- React Hook Form + Zod — 表单方案
- Motion — 动效 (framer-motion)
- next-sitemap + SEO — sitemap/robots/JSON-LD
- Vitest — 单元测试
- Husky + lint-staged — Git hooks
- BFF api-client + Zod env — BFF 中间层
- 包管理器 — pnpm / npm / yarn
CLI 会自动完成:复制模板 → 按选项裁剪 → git init → 安装依赖。
模板技术栈
| 类别 | 选型 | |------|------| | 框架 | Next.js 16 + React 19 (App Router, Turbopack) | | 语言 | TypeScript 5.x | | 样式 | TailwindCSS 4.x | | 状态管理 | Zustand 5.x | | 表单 | React Hook Form + Zod | | 动效 | Motion (framer-motion) 12.x | | 代码质量 | Biome 1.9.4 | | SEO | next-sitemap + Metadata API + JSON-LD | | 测试 | Vitest 4.x | | Git hooks | Husky + lint-staged |
开发
# 安装 CLI 依赖
pnpm install
# 编译 CLI
pnpm build
# 本地测试
node dist/index.js test-app发布
npm publishprepublishOnly 会自动执行 tsc 编译。发布包含 dist/(编译后的 CLI)和 template/(模板源码)。
