create-luote

create-luote

作者: luote (luote)

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

使用方式

npm create luote

一般不必写 @latest：入口会在线查 npm 最新版，发现旧缓存会自动 npx create-luote@latest 重跑。

网络查版本失败时再用：

npm create luote@latest
# 或
npx --yes --prefer-online create-luote@latest

离线或本地调试可设置 CREATE_LUOTE_SKIP_UPDATE=1 跳过检查。

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

luote-app/
├── AGENTS.md
├── .agents/skills/luote-scaffold/   # 全 Agent Skill + gen-crud.js
├── .cursor/skills/luote-scaffold/   # Cursor 镜像
├── luote-app-backend/
├── luote-app-front/
└── luote-app-uniapp/

可直接回车使用默认名，或自行修改项目名（目录、Java 包名、数据库名、品牌文案会同步替换；作者署名与 luote996.cn 保留）。

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

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

项目结构

luote-app/
├── AGENTS.md / .agents/skills / .cursor/skills
├── luote-app-backend/   # Spring Boot 3 + MyBatis-Plus + JWT + Redis
├── luote-app-front/     # Vue3 + TS + Pinia + Element Plus
└── luote-app-uniapp/    # UniApp（H5 + 微信小程序）

后端技术栈

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

Web 前端技术栈

• Vue 3 + TypeScript
• Pinia + Vue Router
• Element Plus + ECharts
• WebSocket Demo（JWT 经 Sec-WebSocket-Protocol）

UniApp 技术栈

• uni-app（Vue3 + Vite + TypeScript + Pinia）
• 登录注册验证码、首页看板、WebSocket、我的
• H5 + 微信小程序；风格与 Web 端一致（淡蓝灰白）

环境变量

后端复制 {项目名}-backend/.env.example 为 .env；Web / UniApp 使用各自 .env.development / .env.production。

默认账号

• 用户名: admin
• 密码: admin123

发布到 npm

# 登录（首次）
npm login

# 发布前自动校验（后端编译、Web 构建、UniApp H5 构建、脚手架三端测试）
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

变更记录

详见 CHANGELOG.md。