Weave

English | 中文

Weave is a Go + Vue3 application starter, simple but functional, supported by gin, gorm, redis, postgres, vue, element-plus, websocket and much more.

See Demo.

Login	Home

Dashboard	App

Web Shell	Web Code Editor

Demo

Demo website: see https://qingwave.github.io/weave/

Run ui with docker(no server and databases)

docker run -d -p 8080:80 --name weave-frontend qingwave/weave-frontend:mock

Features

Server support features:

Restful api, write by gin
MVC structure
Postgres storage, via gorm
Swagger doc, support by swag
Structured log, support by logrus
Prometheus monitor
PProf debug
Graceful shutdown
Authentication, support jwt
Request rate limit, server level or user ip
OAuth Login and store hashed password
Redis cache
RBAC supported
Container application management, support docker and kubernetes
Post management

Frontend support features:

Vue3 supported
UI with element-plus
Build with vite
Charts integration, support by echarts
WebShell supported
Windi CSS
OAuth Login
Web code editor, support by codemirror
MarkDown preview and editor

TODOs

Get started

Before starting, you should already install golang, docker and nodejs in your develop env.

Run server

Env:

golang (1.18 or later)

Install dependencies, postgresql, redis, swag

make init

run locally

make run

run server in docker

# build image
make docker-build-server
# run server
make docker-run-server

For Windows, you can run script in Makefile manually

Test api

See more api in http://localhost:8080/index See swagger http://localhost:8080/swagger/index.html#/

curl -XPOST http://localhost:8080/api/v1/auth/user -d '{"name": "zhang3", "email": "zhang3@t.com","password": "123456"}'

Only admin user can access any apis, other user need create RBAC policy

curl -XPOST http://localhost:8080/api/v1/auth/token -d '{"name": "admin", "password": "123456"}'

Response as follows, set token in Authorization Header

{
  "code": 200,
  "msg": "success",
  "data": {
    "token": "xxx",
    "describe": "set token in Authorization Header, [Authorization: Bearer {token}]"
  }
}

Get users

token=xxx
curl -X 'GET' 'http://localhost:8080/api/v1/users' -H "Authorization: Bearer $token"

Run UI

Assume you have installed Nodejs, if not, install it by nvm

Run ui with mockjs

cd web
npm run mock

If your frontend deploy in the remote, please change server.host and server.https in vite.config.js.

Run ui with command make ui or

cd web
npm i
npm run dev

Default admin user admin/123456 or demo user demo/123456

Only admin user can access all api, other user must config RBAC at first

Explore in http://127.0.0.1:8081

run frontend in docker

# build image
make docker-build-ui
# run frontend
make docker-run-ui

More ui in img

Login page
Dashboard page
App page
Webshell page
Blog list
Article

Documents

Contributing, contributing details
Config, your can enable docker/kubernetes in config
OAuth
RBAC

hanlinwu/weave