# <%= applicationName %>

<%= applicationDesc %>

基于 [Next.js](https://nextjs.org) 与 [MUI](https://mui.com) 的前端模板，使用 pnpm 管理依赖，内置 ESLint 与 Prettier。

## 环境要求

- Node.js >= 20
- pnpm >= 10

## 快速开始

```bash
pnpm install
pnpm dev
```

用浏览器打开 [http://localhost:3000](http://localhost:3000) 即可查看页面。

## 常用命令

| 命令               | 说明                |
| ------------------ | ------------------- |
| `pnpm dev`         | 启动开发服务器      |
| `pnpm build`       | 生产构建            |
| `pnpm start`       | 启动生产服务器      |
| `pnpm lint`        | ESLint 检查         |
| `pnpm format`      | Prettier 格式化代码 |
| `pnpm typecheck`   | TypeScript 类型检查 |

## 目录结构

```
├── public/                  # 静态资源
├── src/
│   ├── actions/             # Server Actions
│   ├── app/                 # App Router 页面与布局
│   │   ├── api/             # API 路由
│   │   ├── layout.tsx       # 根布局（MUI 主题与 Emotion 缓存）
│   │   └── page.tsx         # 首页
│   ├── components/          # 通用组件
│   ├── stores/              # 全局状态
│   ├── theme.ts             # MUI 主题
│   └── utils/               # 工具函数与常量
├── eslint.config.mjs        # ESLint 配置
├── next.config.ts           # Next.js 配置
└── tsconfig.json            # TypeScript 配置（含 @/* 别名）
```