1 files changed, 25 insertions, 7 deletions
diff --git a/webui/Readme.md b/webui/Readme.md
index 2ba94b5d..45df1705 100644
--- a/webui/Readme.md
+++ b/webui/Readme.md
@@ -1,17 +1,35 @@
 # git-bug rich web UI
 
+## Prerequisites
+[ReactJS](https://reactjs.org/) | [Material UI](https://material-ui.com/) | [GraphQL](https://graphql.org/) | [Apollo GraphQL](https://www.apollographql.com/docs/react/)
+
 ## How to develop
 
-1. Compile the go binary
-   - run `make` in the **root** directory
-2. Run the GraphQL backend on the port 3001
-   - `./git-bug webui -p 3001`
-3. Run the hot-reloadable development WebUI
+### Run GraphQL backend
+
+1. Download a git-bug stable binary or compile your own by running `make` in the **root** directory:
+
+2. Run the git-bug binary inside your git repository. It will manage issues and start the API:
+   - `git-bug webui -p 3001`
+
+### Run ReactJS front-end
+
+1. If you haven't already, clone the git-bug repository:
+
+2. Enter the `webui` directory and install the needed libraries:
+   - `make install` or `npm install`
 
-   - run `npm start` in the **webui** directory
+3. Generate the TS code from the GrapQL files and run the webui in development mode:
+   - `make start` or `npm start`
+   - If you get some lint errors, run the lint command below and start again:
+      - `make fix-lint` or `npm run lint -- --fix`
+      - `make start` or `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.
+Once the webUI is good enough for a new release:
+1. run `make build` from webui folder
+2. run `make pack-webui` from the *root directory* to bundle the compiled js into the go binary.
+   - You must have Go installed on Your machine to run this command.
+\ No newline at end of file