# vjmap3d vite app 模板

> 复制模板后把 `_gitignore` 改名为 `.gitignore`（npm 发布会丢弃 `.gitignore` 文件，故以 `_gitignore` 存放）。

```bash
npm i
npm run dev
npm run build
```

## 环境变量

复制 `.env.example` 为 `.env` 并填写：

| 变量 | 默认 | 说明 |
|---|---|---|
| `VITE_VJMAP_SERVICE_URL` | `https://vjmap.com/server/api/v1` | 服务地址 |
| `VITE_VJMAP_TOKEN` | 空 | **必填**：access token（为空时 `new vjmap3d.App` 直接抛 `app parameter service accessToken is null`），勿提交真实值 |
| `VITE_VJMAP_MAPID` | 空 | **必填**：已存在的 CAD 图 mapid（模板无内置演示图，为空时无法打开图） |

注意：`vjmap3d` 是 ESM 且内部 `import 'three'`——npm 场景 bundler 自动解析；three 版本须与 `vjmap3d` 的 peer 一致（npm `vjmap3d@2.0.0` → `three@>=0.185.0`，本模板钉 `^0.185.0`）。