https://github.com/lucky-byte/reactgo
Go + React 快速开发模板
https://github.com/lucky-byte/reactgo
echo-server go material-ui react template
Last synced: about 1 month ago
JSON representation
Go + React 快速开发模板
- Host: GitHub
- URL: https://github.com/lucky-byte/reactgo
- Owner: lucky-byte
- License: mit
- Created: 2022-01-18T00:52:46.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2025-03-20T23:54:11.000Z (11 months ago)
- Last Synced: 2025-03-21T00:28:33.835Z (11 months ago)
- Topics: echo-server, go, material-ui, react, template
- Language: JavaScript
- Homepage: https://reactgo.kross.work
- Size: 6.17 MB
- Stars: 17
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# React + Go 快速开发模板
你可能会遇到一些项目，需要开发的业务不多，需要快速交付，但麻雀虽小，五脏俱全，一些基础功能，
比如用户管理，权限控制...等等都要具备，开发这些基础功能比开发业务功能耗费更多的时间，
使用 ReactGO 的好处是无需投入精力开发这些基础功能，直接进入业务功能开发，缩短交付周期。
**项目尚未达到 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 网站，那需要自行在网上找一些方法。