# website-template

**Repository Path**: bobbyboy/website-template

## Basic Information

- **Project Name**: website-template
- **Description**: next.js 官网模板
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-11
- **Last Updated**: 2025-09-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


## 🚀 快速开始

### 环境要求
- Node.js 18.0+
- npm/yarn/pnpm

### 安装依赖

```bash
npm install
# 或
yarn install
# 或
pnpm install
```

### 启动开发服务器

```bash
npm run dev
# 或
yarn dev
# 或
pnpm dev
```

访问 [http://localhost:3000](http://localhost:3000) 查看应用。

### 构建生产版本

```bash
npm run build
npm run start
```

## 🎨 开发规范

### 代码风格
- 使用 ESLint 进行代码质量检查
- 遵循 Next.js 和 React 最佳实践
- 使用 TypeScript 确保类型安全
- 组件采用函数式组件 + Hooks 模式

### 组件开发
- 组件放置在 `src/components/` 目录下
- 页面级组件放在 `src/components/sections/`
- 通用UI组件放在 `src/components/ui/`
- 布局组件放在 `src/components/layout/`

### 样式规范
- 使用 Tailwind CSS 原子化类名
- 响应式设计优先（mobile-first）
- 支持深色模式切换
- 使用 CSS变量进行主题定制

### 路由结构
- 使用 Next.js App Router
- 页面文件放在 `src/app/` 目录
- 支持嵌套路由和布局

## 🔧 配置说明

### 环境变量
创建 `.env.local` 文件配置环境变量：

```env
# 站点配置
NEXT_PUBLIC_SITE_URL=http://localhost:3000

# API配置
NEXT_PUBLIC_API_URL=your_api_url

# 其他配置...
```

### Tailwind CSS配置
项目使用 Tailwind CSS 4.0，配置文件为 `postcss.config.mjs`。支持：
- 自定义颜色主题
- 响应式断点
- 动画效果
- 组件样式

### TypeScript配置
- 启用严格模式
- 配置路径别名 `@/*` 指向 `src/*`
- 支持 JSX 和现代 ES 特性

## 📦 部署

### Vercel部署（推荐）
1. 连接 GitHub 仓库到 Vercel
2. 自动检测 Next.js 项目
3. 一键部署

### 其他平台
- **Netlify**: 支持静态导出
- **Docker**: 容器化部署
- **传统服务器**: Node.js环境部署

## 🤝 贡献指南

1. Fork 项目仓库
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

### 提交规范
使用约定式提交格式：
- `feat:` 新功能
- `fix:` 修复bug
- `docs:` 文档更新
- `style:` 代码格式调整
- `refactor:` 代码重构
- `test:` 测试相关
- `chore:` 构建过程或辅助工具的变动