# cb-react

**Repository Path**: zhaojianchn/cb-react

## Basic Information

- **Project Name**: cb-react
- **Description**: 跨境工具箱-前端
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-30
- **Last Updated**: 2025-11-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CB React 项目

这是一个基于Vite + React + Zustand + Semi-ui的项目模板，遵循最佳实践和规范。

## 技术栈

- **React 18**：使用最新的React特性
- **TypeScript**：提供类型安全
- **Vite**：快速的开发体验和构建工具
- **Zustand**：简单高效的状态管理
- **Semi Design**：美观现代的UI组件库
- **React Router**：路由管理
- **i18next**：国际化支持
- **Axios**：HTTP请求库

## 项目结构

```
src/
├── assets/         # 静态资源
├── components/     # 组件（UI组件和通用业务组件）
├── hooks/          # 自定义hooks
├── layouts/        # 布局组件
├── pages/          # 页面组件
├── routes/         # 路由配置
├── stores/         # Zustand状态管理
├── services/       # API服务层
├── types/          # TypeScript类型定义
├── utils/          # 工具函数
├── locales/        # 国际化资源
│   ├── zh-CN/      # 简体中文
│   └── en-US/      # 英文
├── i18n/           # 国际化配置
├── App.tsx         # 应用入口组件
└── main.tsx        # 应用入口文件
```

## 快速开始

### 安装依赖

```bash
npm install
```

### 开发环境运行

```bash
npm run dev
```

### 构建生产版本

```bash
npm run build
```

### 代码规范检查

```bash
npm run lint
```

## 主要特性

- **组件化开发**：组织结构清晰，便于维护
- **类型安全**：使用TypeScript提高代码质量和开发体验
- **状态管理**：使用Zustand进行简单高效的状态管理
- **国际化**：内置i18next支持多语言
- **响应式设计**：使用Semi Design的响应式组件
- **路由管理**：集成React Router进行路由管理
- **API封装**：统一的API请求层

## 规范指南

- 组件文件使用PascalCase命名
- 组件目录可使用kebab-case
- API调用统一通过services层进行
- 状态管理使用Zustand创建store
- 所有UI文本必须使用i18n国际化

## 开发团队

CB React Team

## 许可证

MIT