64 lines
1.6 KiB
Markdown
64 lines
1.6 KiB
Markdown
# 项目概览
|
|
|
|
## 项目名称
|
|
next-simple-template
|
|
|
|
## 包名/作用域
|
|
@kevisual/next-simple-template
|
|
|
|
## 项目描述
|
|
Light Code - 一个直觉、高效的代码编辑器前端界面
|
|
|
|
## 技术栈
|
|
- **框架**: Next.js 16.1.1 (App Router)
|
|
- **语言**: TypeScript 5
|
|
- **UI库**: React 19.2.3
|
|
- **样式**: Tailwind CSS 4
|
|
- **组件库**: Radix UI (Dialog, Slot, etc.)
|
|
- **状态管理**: Zustand valtio
|
|
- **图标**: Lucide React
|
|
- **工具库**:
|
|
- class-variance-authority (组件变体)
|
|
- clsx + tailwind-merge (样式处理)
|
|
- react-toastify (通知)
|
|
- **请求库**（自定义框架）
|
|
- @kevisual/query
|
|
|
|
|
|
## 项目结构
|
|
```
|
|
src/
|
|
├── app/
|
|
│ ├── layout.tsx # 根布局,配置字体和元数据
|
|
│ ├── page.tsx # 首页组件
|
|
│ └── globals.css # 全局样式
|
|
├── components/
|
|
│ └── ui/
|
|
│ ├── button.tsx # 按钮组件 (支持多种变体)
|
|
│ └── dialog.tsx # 对话框组件
|
|
├── lib/
|
|
│ └── utils.ts # 工具函数 (cn类名合并)
|
|
└── proxy.ts # 代理配置
|
|
```
|
|
|
|
## 核心配置
|
|
- **路径别名**: `@/*` 映射到 `./src/*`
|
|
- **构建输出**:
|
|
- 开发环境: 标准Next.js
|
|
- 生产环境: 静态导出到 `dist` 目录
|
|
- **Base Path**: 生产环境使用 `basename` 路径
|
|
|
|
## 可用命令
|
|
- `pnpm dev` - 启动开发服务器
|
|
- `pnpm build` - 构建生产版本
|
|
- `pnpm start` - 启动生产服务器
|
|
- `pnpm pub` - 部署到远程
|
|
- `pnpm ui` - 添加shadcn组件
|
|
|
|
## 特性
|
|
- 深色模式支持
|
|
- 响应式设计
|
|
- TypeScript严格模式
|
|
- 可访问性组件 (Radix UI)
|
|
- 静态导出支持
|