gin
1c3f8b39a3
Co-authored-by: gin <gin-18@qq.com> Co-authored-by: gin <dengxinmin@owlscm.com> Reviewed-on: #1
67 lines
1.1 KiB
Markdown
67 lines
1.1 KiB
Markdown
# CollabLedger Web
|
|
|
|
Vite + Vue 3 Web 管理端，作为根目录 pnpm workspace 的子包维护。
|
|
|
|
## 本地开发
|
|
|
|
从仓库根目录执行：
|
|
|
|
```bash
|
|
pnpm install
|
|
pnpm dev:web
|
|
```
|
|
|
|
`frontend/web/.env.development` 默认使用：
|
|
|
|
```env
|
|
VITE_PORT=80
|
|
VITE_APP_BASE_API=/dev-api
|
|
```
|
|
|
|
开发环境下，`vite.config.ts` 会把 `/dev-api` 代理到本地后端 `http://localhost:3000`。
|
|
|
|
## Vercel 部署
|
|
|
|
Web 管理端作为独立的 Vercel Project 部署。先全局安装并登录 Vercel CLI：
|
|
|
|
```bash
|
|
pnpm add -g vercel
|
|
vercel login
|
|
```
|
|
|
|
进入 Web 目录并关联项目：
|
|
|
|
```bash
|
|
cd frontend/web
|
|
vercel link
|
|
```
|
|
|
|
推荐配置：
|
|
|
|
```text
|
|
Framework Preset: Vite
|
|
Install Command: pnpm install
|
|
Build Command: pnpm build
|
|
Output Directory: dist
|
|
```
|
|
|
|
在 Vercel 项目环境变量中配置后端地址：
|
|
|
|
```bash
|
|
vercel env add VITE_APP_BASE_API production
|
|
```
|
|
|
|
变量值示例：
|
|
|
|
```env
|
|
VITE_APP_BASE_API=https://your-backend.example.com
|
|
```
|
|
|
|
部署：
|
|
|
|
```bash
|
|
vercel deploy --prod
|
|
```
|
|
|
|
`vercel.json` 已配置 SPA 路由回退，刷新管理端子路由时会返回 `index.html`。
|