# 项目概览 ## 项目名称 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) - 静态导出支持