frontend-template-react/README.md

Frontend Template

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

技术栈

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

快速开始

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/ 下的占位页面

常用命令

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