feat: 初始化项目配置和基础架构
- 添加项目配置文件:.vercelignore、.codex/config.toml、postcss.config.js、.prettierrc 等 - 设置构建工具链:Vite + React + TypeScript + TailwindCSS - 添加核心组件:HeaderBar、TierRow、ItemCard、Pool - 配置 CI/CD 和部署相关文件:vercel.json、DEPLOY.md - 添加开发工具配置:ESLint、Prettier、EditorConfig - 实现基础功能:拖拽排序、图片处理、状态管理
This commit is contained in:
40
.trae/documents/改造项目以适配 Vercel 部署.md
Normal file
40
.trae/documents/改造项目以适配 Vercel 部署.md
Normal file
@ -0,0 +1,40 @@
|
||||
## 当前状态
|
||||
- 技术栈:Vite + React + TypeScript(已存在 `package.json`, `vite.config.ts`)
|
||||
- Vercel 配置:已存在 `vercel.json`(含 SPA 重写到 `index.html`)与 `.vercelignore`、`.vercel/project.json`
|
||||
- 构建脚本:`npm run build` 输出到 `dist/`
|
||||
|
||||
## 改造目标
|
||||
- 明确 Vercel 静态站点配置,确保自动检测稳健
|
||||
- 完善忽略与环境变量约定,避免意外上传或路由异常
|
||||
|
||||
## 将进行的改动
|
||||
1. 更新 `vercel.json`
|
||||
- 明确声明:
|
||||
- `framework: "vite"`
|
||||
- `buildCommand: "npm run build"`
|
||||
- `outputDirectory: "dist"`
|
||||
- 保留现有 SPA 重写:`{"source":"/(.*)","destination":"/index.html"}`
|
||||
2. 优化 `.vercelignore`
|
||||
- 保留:`node_modules`, `.git`, `dist`, `build`, `.trae`, `.figma`
|
||||
- 新增:`.env`, `.env.*`(避免上传本地环境文件)
|
||||
3. 校正 Vite 基础路径(如需)
|
||||
- 在 `vite.config.ts` 明确 `base: '/'`(当前默认即可,若将来挂子路径可再调整)
|
||||
4. 部署与验证文档(新增简要说明)
|
||||
- 使用 CLI:`vercel`(预览)、`vercel --prod`(生产)
|
||||
- 仪表盘设置环境变量:使用 `VITE_*` 前缀(例如 `VITE_API_BASE`)
|
||||
|
||||
## 验证步骤
|
||||
- 本地:`npm run build` 验证生成 `dist/`
|
||||
- Vercel:自动检测 Vite,执行构建,路由通过 `rewrites` 走 `index.html`
|
||||
- 访问任意深层路径(如 `/pool/123`),确认前端路由正常
|
||||
|
||||
## 交付物
|
||||
- `vercel.json`(更新为包含 framework/buildCommand/outputDirectory + rewrites)
|
||||
- `.vercelignore`(新增环境变量忽略项)
|
||||
- `vite.config.ts`(如需,补充 `base: '/'`)
|
||||
- `DEPLOY.md`(简要部署与环境变量约定说明)
|
||||
|
||||
## 影响与说明
|
||||
- 构建与运行逻辑不变;仅提升 Vercel 适配与稳定性
|
||||
- 不提交任何秘钥;环境变量在 Vercel 仪表盘设置
|
||||
- 若后续引入服务端 API,可在 `api/` 目录添加 Serverless Functions 并扩展 `vercel.json` 路由
|
||||
45
.trae/documents/添加 .gitignore 并配置忽略规则.md
Normal file
45
.trae/documents/添加 .gitignore 并配置忽略规则.md
Normal file
@ -0,0 +1,45 @@
|
||||
## 项目检测结论
|
||||
- 当前为 Node.js + Vite + TypeScript 项目(存在 `package.json`, `vite.config.ts`, `tsconfig.json`)
|
||||
- 尚未存在 `.gitignore`;常见生成目录(如 `dist/`、`build/`、`coverage/`)目前未生成,但应预先忽略
|
||||
|
||||
## 将新增的文件
|
||||
- 在项目根目录创建 `.gitignore`
|
||||
|
||||
## 忽略规则(按类别)
|
||||
- 依赖目录:
|
||||
- `node_modules/`
|
||||
- 构建产物:
|
||||
- `dist/`
|
||||
- `build/`
|
||||
- 测试与覆盖率:
|
||||
- `coverage/`
|
||||
- 日志:
|
||||
- `*.log`
|
||||
- `npm-debug.log*`
|
||||
- `yarn-debug.log*`
|
||||
- `yarn-error.log*`
|
||||
- `pnpm-debug.log*`
|
||||
- `lerna-debug.log*`
|
||||
- 编辑器与 IDE:
|
||||
- `.vscode/`
|
||||
- `.idea/`
|
||||
- 操作系统:
|
||||
- `.DS_Store`
|
||||
- `Thumbs.db`
|
||||
- 环境变量:
|
||||
- `.env`
|
||||
- `.env.*`
|
||||
- `!.env.example`
|
||||
- TypeScript 与工具缓存:
|
||||
- `*.tsbuildinfo`
|
||||
- `.eslintcache`
|
||||
- `.tmp/`
|
||||
- `.cache/`
|
||||
|
||||
## 说明
|
||||
- 不忽略 `package-lock.json`,保持可重复安装
|
||||
- 以上规则覆盖 Vite/TS 常见产物与通用杂项,安全且常用
|
||||
|
||||
## 验证方式
|
||||
- 创建后运行构建与开发流程,确认新生成的产物未被纳入 Git 变更
|
||||
- 可根据后续引入的工具(如 Cypress、Storybook 等)补充相应忽略项
|
||||
Reference in New Issue
Block a user