---
id: app-scaffold
name: 应用脚手架模板
area: frontend
status: concept
---

## 概述

新 app 的起始模板，包含 Vite 项目配置、HTML 入口、React 根组件、环境变量规范。monorepo 中每个 app 从此模板派生。

## 任务卡

### 💭 创建第一个 App（apps/app-one）
- status: concept
- complexity: M
- files: apps/app-one/package.json, apps/app-one/vite.config.ts, apps/app-one/index.html, apps/app-one/src/main.tsx, apps/app-one/src/App.tsx
- acceptance: pnpm dev 能启动，pnpm build 产出 dist/，src/App.tsx 渲染 Hello World，正确引入 @repo/ui 和 @repo/utils

### 💭 移动端视口基础配置
- status: concept
- complexity: S
- files: apps/app-one/index.html, apps/app-one/src/styles/global.css
- acceptance: meta viewport 设置 initial-scale=1，禁用双击缩放，全局 CSS reset 适配移动端（100dvh、touch-action 等）

## 决策记录

- 每个 app 独立配置 Vite 而非共享一个构建进程：便于各 app 独立部署和差异化配置，构建缓存也可隔离