# react-trpc-hono-bun

**Repository Path**: youwei997/react-trpc-hono-bun

## Basic Information

- **Project Name**: react-trpc-hono-bun
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-15
- **Last Updated**: 2025-06-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# React Router + Hono 单仓库模板

一个用于构建全栈 React 应用的现代、可生产部署的模板，结合了最新的 React Router v7、Hono 后端和 Bun 工具链。

## 特性

- 🚀 服务器端渲染 (SSR)
- ⚡ 热模块替换 (HMR)
- 🛠 支持 tRPC API 交互
- 🎯 零配置客户端-服务端类型共享
- 🧪 集成 Playwright 和 Vitest 进行端到端及集成测试
- 🎨 配备 Tailwind CSS 样式框架
- 📦 使用 Vite 构建工具
- 🚦 Biome 用于代码规范
- 🔄 Turborepo 支持快速构建

## 技术栈

| 类别              | 技术                                                                                             | 版本        |
|-------------------|--------------------------------------------------------------------------------------------------|-------------|
| 构建系统          | [Turborepo](https://turbo.build/repo)                                                           | 2.3.3       |
| 运行时/工作区     | [Bun](https://bun.sh)                                                                           | 1.1.38      |
| 代码规范          | [Biome](https://biomejs.dev/)                                                                    | 1.9.4       |
| 语言              | [TypeScript](https://www.typescriptlang.org/)                                                    | 5.5.4       |
| 后端框架          | [Hono](https://hono.dev)                                                                        | 4.6.13      |
| API                | [tRPC](https://trpc.io)                                                                        | 11.0.0-rc.660 |
| 数据校验          | [Zod](https://zod.dev)                                                                          | 3.23.8      |
| 路由              | [React Router](https://reactrouter.com)                                                          | 7.0.2       |
| 前端框架          | [React](https://react.dev)                                                                       | 19.0.0      |
| UI 样式           | [Tailwind CSS](https://tailwindcss.com)                                                         | 4.0.0-beta.6|
| 端到端测试        | [Playwright](https://playwright.dev)                                                            | 1.49.0      |
| 集成测试          | [Vitest (浏览器模式)](https://vitest.dev)                                                       | 2.1.8       |
| 构建工具          | [Vite](https://vitejs.dev)                                                                      | 6.0.3       |
| 持续集成          | [GitHub Actions](https://github.com/features/actions)                                            | N/A         |

## 开始

### 安装

```shell
git clone https://github.com/barclayd/react-router-trpc-hono-bun-template
cd react-router-trpc-hono-bun-template
bun install
```

### 本地开发

```shell
bun run dev
```

### 构建生产版本

```shell
bun run build
```

### 部署

#### Docker 部署

```shell
docker build -t react-router-app .
docker run -p 3000:3000 react-router-app
```

#### 自定义部署

使用 Bun 手动部署：

```shell
bun run start
```

## 目录结构

```
.
├── apps/
│   ├── web/                  React Router 前端
│   │   ├── app/             路由和组件
│   │   └── package.json     React 19, React Router, tRPC 客户端
│   └── server/              Hono 后端
│       ├── src/             API 路由和业务逻辑
│       └── package.json     Hono, tRPC 服务端
├── package.json             工作区依赖
└── turbo.json               Turborepo 配置
```

## 样式

本模板已配置 [Tailwind CSS](https://tailwindcss.com)，提供简洁的默认样式体验。你可以使用任何你喜欢的 CSS 框架。

## 测试

- E2E 测试使用 [Playwright](https://playwright.dev)
- 集成测试使用 [Vitest (浏览器模式)](https://vitest.dev)

## 许可证

本项目采用 MIT 许可证。详情请查看 `package.json` 和 `bun.lock` 文件。