@svton/cli

Svton CLI - 使用 NestJS、Next.js 和 Taro 创建全栈应用

特性

• 🚀 全栈模板 - 后端 (NestJS)、管理后台 (Next.js)、移动端 (Taro)
• 📦 Monorepo 架构 - Turbo + pnpm workspace 预配置
• 🎯 多种模板 - 按需选择：全栈、仅后端、仅管理后台、仅移动端
• 🛠️ 开发体验 - ESLint、Prettier、TypeScript 预配置
• 🐳 Docker 支持 - 内置 MySQL 和 Redis 容器配置
• 📚 类型安全 - 共享类型定义和 API 接口

快速开始

# 推荐方式 (npx)
npx @svton/cli create my-app

# 全局安装后使用
npm install -g @svton/cli
svton create my-app

使用方法

svton create <project-name> [options]
svton init <project-name> [options]   # 别名
svton new <project-name> [options]    # 别名

选项

• -o, --org <name> - 组织名称（默认：项目名）
• --skip-install - 跳过依赖安装
• --skip-git - 跳过 Git 初始化
• -t, --template <template> - 使用的模板（full-stack、backend-only、admin-only、mobile-only）
• -p, --package-manager <pm> - 包管理器（npm、yarn、pnpm）

示例

# 创建全栈应用
svton create my-app

# 使用自定义组织名
svton create my-app --org my-company

# 创建仅后端项目
svton create my-api --template backend-only

# 跳过依赖安装
svton create my-app --skip-install

模板

全栈模板 (full-stack)

完整应用包含：

• 后端: NestJS + Prisma + MySQL + Redis
• 管理后台: Next.js + TailwindCSS + shadcn/ui
• 移动端: Taro + React (微信小程序)
• 共享类型: TypeScript 类型定义

仅后端 (backend-only)

• NestJS API 服务器
• Prisma ORM + MySQL
• JWT 认证
• Redis 缓存
• Swagger 文档

仅管理后台 (admin-only)

• Next.js 15 + App Router
• TailwindCSS + shadcn/ui
• TypeScript + ESLint
• API 客户端集成

仅移动端 (mobile-only)

• Taro 3.6 框架
• React 18
• 微信小程序支持
• TypeScript + ESLint

项目架构

使用 svton 创建的项目遵循以下架构：

my-app/
├── apps/
│   ├── backend/        # @my-org/backend
│   ├── admin/          # @my-org/admin
│   └── mobile/         # @my-org/mobile
├── packages/
│   └── types/          # @my-org/types
├── package.json
├── pnpm-workspace.yaml
├── turbo.json
└── docker-compose.yml

创建后的步骤

1. 启动数据库（全栈/后端模板）：

   docker-compose up -d

2. 配置环境变量：

   cp apps/backend/.env.example apps/backend/.env
   # 编辑 .env 文件配置你的设置

3. 运行数据库迁移（后端模板）：

   pnpm --filter @my-org/backend prisma:generate
   pnpm --filter @my-org/backend prisma:migrate

4. 启动开发服务器：

   pnpm dev

环境要求

• Node.js >= 18.0.0
• npm、yarn 或 pnpm（推荐 pnpm）
• Docker（用于数据库服务）

许可证

MIT © SVTON Team