# Frontend Template

React + TypeScript + Vite 前端通用模板。目录结构与开发规范见 [AGENTS.md](./AGENTS.md)。

## 技术栈

React 19 · TypeScript · Vite · Tailwind CSS v4 · Ant Design · Zustand · TanStack Query · Axios · React Router

## 快速开始

```bash
pnpm install
cp .env.example .env.local   # 按需修改接口地址与代理目标
pnpm dev
```

## 使用模板新建项目后需要修改

- `package.json` 的 `name`
- `index.html` 的 `<title>`
- `.env.local` 中的 `DEV_PROXY_TARGET`、`VITE_API_BASE_URL`
- `src/constants/api.ts` 中的 `LOGIN_PATH`、`UNAUTHORIZED_IGNORE_URLS`
- `src/theme/index.ts` 中的主题色
- `src/pages/` 下的占位页面

## 常用命令

```bash
pnpm dev      # 开发
pnpm build    # 类型检查 + 构建
pnpm lint     # ESLint
pnpm preview  # 预览构建产物
```