update
This commit is contained in:
@@ -1,63 +1,48 @@
|
|||||||
# 项目概览
|
# AGENTS.md
|
||||||
|
|
||||||
## 项目名称
|
|
||||||
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 (样式处理)
|
|
||||||
- sonner (通知)
|
|
||||||
- **请求库**(自定义框架)
|
|
||||||
- @kevisual/query
|
|
||||||
|
|
||||||
|
本指南为在此仓库中工作的 AI 编码代理提供关键信息。
|
||||||
|
|
||||||
## 项目结构
|
## 项目结构
|
||||||
|
|
||||||
```
|
```
|
||||||
src/
|
src/
|
||||||
├── app/
|
├── components/ui/ # shadcn/ui 组件(Base UI 基础组件)
|
||||||
│ ├── layout.tsx # 根布局,配置字体和元数据
|
├── lib/ # 工具函数(cn() 函数用于 className 合并)
|
||||||
│ ├── page.tsx # 首页组件
|
├── modules/ # 应用模块(query client、basename)
|
||||||
│ └── globals.css # 全局样式
|
├── pages/ # 页面组件(默认导出)
|
||||||
├── components/
|
├── routes/ # TanStack Router 基于文件的路由
|
||||||
│ └── ui/
|
├── styles/ # 全局样式、主题 CSS
|
||||||
│ ├── button.tsx # 按钮组件 (支持多种变体)
|
└── main.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组件
|
|
||||||
|
|
||||||
## 特性
|
### 模块目录结构
|
||||||
- 深色模式支持
|
|
||||||
- 响应式设计
|
每个新模块(如 `page-app`)应遵循以下结构:
|
||||||
- TypeScript严格模式
|
|
||||||
- 可访问性组件 (Radix UI)
|
```
|
||||||
- 静态导出支持
|
pages/page-app/
|
||||||
|
├── components/ # 模块专属组件
|
||||||
|
├── store/ # 模块状态管理
|
||||||
|
└── module/ # 模块功能函数
|
||||||
|
```
|
||||||
|
|
||||||
|
### 状态和数据获取
|
||||||
|
|
||||||
|
- **Zustand** 用于全局状态管理
|
||||||
|
- **@kevisual/query** 用于数据获取(QueryClient 实例位于 `src/modules/query.ts`)
|
||||||
|
- **React Hook Form** 用于表单管理
|
||||||
|
|
||||||
|
## 核心依赖
|
||||||
|
|
||||||
|
- **@base-ui/react**: Headless UI 基础组件
|
||||||
|
- **@tanstack/react-router**: 基于 TanStack Router 插件的文件路由
|
||||||
|
- **class-variance-authority**: 基于变体的样式系统
|
||||||
|
- **clsx + tailwind-merge**: 通过 `cn()` 提供 className 工具函数
|
||||||
|
- **lucide-react**: 图标库
|
||||||
|
- **react-hook-form**: 表单处理
|
||||||
|
- **sonner**: Toast 通知
|
||||||
|
- **zustand**: 状态管理
|
||||||
|
- **tailwindcss v4**: 使用 @tailwindcss/vite 插件进行样式处理
|
||||||
1061
web/bun.lock
Normal file
1061
web/bun.lock
Normal file
File diff suppressed because it is too large
Load Diff
@@ -1,13 +1,13 @@
|
|||||||
{
|
{
|
||||||
"name": "@kevisual/router-studio",
|
"name": "@kevisual/router-studio",
|
||||||
"version": "0.1.5",
|
"version": "0.1.6",
|
||||||
"basename": "/root/router-studio",
|
"basename": "/root/router-studio",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"dev": "vite",
|
"dev": "vite",
|
||||||
"build": "vite build",
|
"build": "vite build",
|
||||||
"preview": "vite preview",
|
"preview": "vite preview",
|
||||||
"ui": "pnpm dlx shadcn@latest add ",
|
"ui": "bunx shadcn@latest add ",
|
||||||
"pub": "envision deploy ./dist -k router-studio -v 0.1.5 -y y -u"
|
"pub": "envision deploy ./dist -k router-studio -v 0.1.6 -y y -u"
|
||||||
},
|
},
|
||||||
"files": [
|
"files": [
|
||||||
"dist"
|
"dist"
|
||||||
@@ -23,7 +23,6 @@
|
|||||||
"clsx": "^2.1.1",
|
"clsx": "^2.1.1",
|
||||||
"cmdk": "^1.1.1",
|
"cmdk": "^1.1.1",
|
||||||
"dayjs": "^1.11.19",
|
"dayjs": "^1.11.19",
|
||||||
"dotenv": "^17.3.1",
|
|
||||||
"es-toolkit": "^1.44.0",
|
"es-toolkit": "^1.44.0",
|
||||||
"fuse.js": "^7.1.0",
|
"fuse.js": "^7.1.0",
|
||||||
"idb-keyval": "^6.2.2",
|
"idb-keyval": "^6.2.2",
|
||||||
@@ -35,7 +34,6 @@
|
|||||||
"react-hook-form": "^7.71.1",
|
"react-hook-form": "^7.71.1",
|
||||||
"react-resizable-panels": "^4.6.4",
|
"react-resizable-panels": "^4.6.4",
|
||||||
"sonner": "^2.0.7",
|
"sonner": "^2.0.7",
|
||||||
"tailwind-merge": "^3.4.1",
|
|
||||||
"valtio": "^2.3.0",
|
"valtio": "^2.3.0",
|
||||||
"zustand": "^5.0.11"
|
"zustand": "^5.0.11"
|
||||||
},
|
},
|
||||||
|
|||||||
Reference in New Issue
Block a user