aboutsummaryrefslogtreecommitdiffstats
path: root/webui/Readme.md
blob: d1420b4f03e9ac7c38507a7893218e1f58bcb938 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
# git-bug rich web UI

## How to develop

### Run GraphQL backend

1. Download a git-bug stable binary.

2. Execute git-bug binary inside directory for the git repository it will manage issues:
   - git-bug webui -p 3001

### Run ReactJS front-end

1. Clone git-bug repository.

2. Enter webui directory and install libraries needed:
   - npm install

3. Generate ts code from graphql files and run webui in development mode
   - npm start
   - If You got compilation errors from lint, run lint command below and start again:
      - npm run lint -- --fix
      - npm start

The development version of the WebUI is configured to query the backend on the port 3001. You can now live edit the js code and use the normal backend.

## Bundle the web UI

Once the webUI is good enough for a new release, run `make pack-webui` from the root directory to bundle the compiled js into the go binary.