# reactgo

**Repository Path**: lucky-byte/reactgo

## Basic Information

- **Project Name**: reactgo
- **Description**: React + Go 项目模板
- **Primary Language**: Go
- **License**: MIT
- **Default Branch**: main
- **Homepage**: https://reactgo.kross.work
- **GVP Project**: No

## Statistics

- **Stars**: 7
- **Forks**: 1
- **Created**: 2022-01-21
- **Last Updated**: 2025-04-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: React, Go语言

## README

# React + Go 快速开发模板

你可能会遇到一些项目，需要开发的业务不多，需要快速交付，但麻雀虽小，五脏俱全，一些基础功能，
比如用户管理，权限控制...等等都要具备，开发这些基础功能比开发业务功能耗费更多的时间，
使用 ReactGO 的好处是无需投入精力开发这些基础功能，直接进入业务功能开发，缩短交付周期。

![截屏](screenshot.jpg)

**项目尚未达到 1.0 状态，欢迎试用，如有问题请提交 issue**

## 文档

https://reactgo.kross.work

## DEMO

[演示地址](http://reactgo.lucky-byte.net:23890/)，账号密码: `reactgo`

## 快速上手

### 准备工作

需要一台安装 nodejs 和 go 编译环境的主机，本文档以 MacOS 为例， 其他系统需要做适当的调整。

### 创建新仓库

#### GITHUB（新仓库只有代码，没有提交历史）

打开 [ReactGo 仓库](https://github.com/lucky-byte/reactgo)，
在页面中找到 `Use this template` 绿色按钮，点击它（懒得找直接点
[这里](https://github.com/lucky-byte/reactgo/generate) 也行），
将开始创建一个新的仓库，按照页面的提示创建仓库，完成后 clone 到你的开发机。

#### GITEE 及其它平台

在项目页面找到 `Fork` 按钮，点击创建你的 fork 仓库，完成后将你的仓库 clone 到你的开发机。

### 初始化数据库

这一步将创建数据库和数据表，ReactGO 支持 `Sqlite`, `MySQL`, 以及 `PostgreSQL`。

这里以 Sqlite 为例，打开一个终端窗口，进入 `migrate` 子目录，有 3 种方式可用：

1. 使用 migrate 命令（这是推荐的方式）:

   ```
   ./migrate-sqlite.sh up
   ```
   创建的数据库文件为 `/tmp/reactgo.db`。

   > 安装 migrate
   >
   > 可以从 [migrate 项目页](https://github.com/golang-migrate/migrate/releases)
   > 下载对应的版本安装，
   > 请注意，该版本不支持 Sqlite 驱动，如果要用 Sqlite 驱动，还需要从源码编译。

2. 使用 sqlite3 命令（临时方案，不推荐）：

   如果你暂时不想安装 migrate 工具，你可以用 sqlite3 命令初始化数据库，这需要安装 sqlite3 工具。

   ```shell
   sqlite3 /tmp/reactgo.db -init ./001_v0.up.sql --version
   ```

3. 直接将 `001_v0.up.sql` 中的 SQL 语句复制到你的数据库客户端执行（临时方案，不推荐）。

### 启动前端

开一个终端窗口，进入仓库 `web` 子目录，运行 ⑴ `yarn` 安装 npm 模块，
然后运行 ⑵ `yarn build` 构建，完了运行 ⑶ `yarn start` 启动前端开发服务器，
会在浏览器打开登录页面。
一共要运行 3 个命令。

### 启动后端

运行 ⑴ `make` ，完了运行 ⑵ `./reactgo -adduser -config ./config.yaml`，
按照提示添加一个后台用户（**注意会在终端打印一个随机密码**，登录需要）。

运行 ⑶ `make dev` 启动后台服务，然后转到浏览器，使用刚刚创建的用户登录。

### 遇到问题

我们的目标是让系统即可能的简单，如果你按照上面的操作出现问题，说明系统还不够简单，请
[提交一个 issue](https://github.com/lucky-byte/reactgo/issues)。
如果是网络连接方面的问题，例如不能访问 npm 或 github 网站，那需要自行在网上找一些方法。