From 01500682f7cf450e0ac46bb0ae580ef155967664 Mon Sep 17 00:00:00 2001 From: "dennis.ludwig" Date: Mon, 21 Jun 2021 14:49:05 +0200 Subject: [PATCH] Explain more in the Readme.md to make local development easier. --- Readme.md | 36 +++++++++++++++++++++++------------- 1 file changed, 23 insertions(+), 13 deletions(-) diff --git a/Readme.md b/Readme.md index de617e3..f147368 100644 --- a/Readme.md +++ b/Readme.md @@ -1,19 +1,29 @@ # AOE Technology Radar -## Generate json file of the markdown files +## Development +### Host the application under a sub path +To host the application under a sub path, set the environment variable `PUBLIC_URL`, e.g. "/techradar". The default is "/techradar". +For local development I recommend using "/build" and use this for the following steps. + +### Build the radar +``` +yarn build +python3 -m http.server 8080 +``` + +Then open here: http://localhost:8080/build + +### Build the radar with static files +``` +yarn build:static +python3 -m http.server 8080 +``` + +Then open here: http://localhost:8080/build + +### Regenerate the json file based on your changes on md files ``` yarn generateJson ``` -## Build the radar -``` -yarn build -``` - -## Serve -``` -cd build -python3 -m http.server 8080 -``` - -Then open here: http://localhost:8080 +You can do this while the server is running. You can find the newly created rd.json in "/build/rd.json".