next-simple-template/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 (样式处理)
  • 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)
• 静态导出支持