create-luote

作者: luote (luote)

• 个人主页: https://luote996.cn
• 在线文档: https://create.luote996.cn 一键创建 luote 全栈项目脚手架，包含 Spring Boot 3 后端与 Vue3 前端。

使用方式

npm create luote

执行时会自动检测 npm 最新版并升级（无需手写 @latest）。离线或本地调试可设置 CREATE_LUOTE_SKIP_UPDATE=1 跳过。

运行后会进入交互式创建页面，默认项目名为 luote-app，将生成：

luote-app/
├── luote-app-backend/
└── luote-app-front/

可直接回车使用默认名，或自行修改项目名（前后端目录会同步替换）。

也支持直接指定项目名（跳过交互）：

npm create luote my-app
# 生成 my-app/my-app-backend / my-app/my-app-front

项目结构

luote-app/
├── luote-app-backend/   # Spring Boot 3 + MyBatis-Plus + JWT + Redis
└── luote-app-front/     # Vue3 + TS + Pinia + Element Plus

后端技术栈

• Spring Boot 3 + JDK 17
• MyBatis-Plus
• Spring Security + JWT
• Redis
• SpringDoc OpenAPI (Swagger)
• Spring AI Alibaba（DashScope 通义千问）验证拦截
• MinIO 对象存储 + 阿里云 OSS 保底
• JetCache 缓存（穿透/击穿/雪崩/热点/预热/大 key）

前端技术栈

• Vue 3 + TypeScript
• Pinia + Vue Router
• Element Plus + ECharts

环境变量

后端复制 {项目名}-backend/.env.example 为 .env，前端使用 .env.development / .env.production。

默认账号

• 用户名: admin
• 密码: admin123

发布到 npm

# 登录（首次）
npm login

# 发布前自动校验（后端编译、前端构建、脚手架测试）
npm publish

包名：create-luote，用户使用 npm create luote 创建项目。

在线文档

完整文档（含二次开发教程）: https://create.luote996.cn

本地文档（VitePress）

源码内附带 VitePress 文档，用于构建 create.luote996.cn，不会发布到 npm。

npm install
npm run docs:dev

文档入口：二次开发 → 开发入门 → 实战：新增模块 → 注意事项与踩坑

构建静态站点：

npm run docs:build
npm run docs:preview

许可证

MIT