Add development instructions and improve development environment for todoblue

README.md

@@ -43,6 +43,12 @@ Build instructions are provided for the two modules:
 - [todored](todored/BUILD.md)
 - [todoblue](todoblue/BUILD.md)
 
+## Development
+
+Development instructions are provided for the two modules:
+- [todored](todored/DEVELOP.md)
+- [todoblue](todoblue/DEVELOP.md)
+
 ## License
 
 This project is licensed under the [AGPL-3.0-or-later](./LICENSE.txt).

todoblue/DEVELOP.md

@@ -0,0 +1,37 @@
+# Development
+
+## Prerequisites
+
+To run `todoblue` locally for development, the following software must be installed on your local machine:
+
+- [Node.JS](https://nodejs.org/)
+- [Yarn](https://yarnpkg.com/)
+
+## Dependencies
+
+Before being able to run `todoblue`, dependencies must be installed via Yarn:
+
+```console
+$ yarn install
+```
+
+As with all Node.JS applications, dependencies are placed in the `node_modules/` directory.
+
+## Configuration
+
+Development `todoblue` instances require some environment variables to be set:
+
+```dotenv
+# The URL where the todored backend can be found at.
+NEXT_PUBLIC_TODOBLUE_OVERRIDE_BASE_URL=http://ethernet.nitro.home.steffo.eu:8080
+```
+
+## Running
+
+A run-script is provided for running the development server, and it can be run via Yarn:
+
+```console
+$ yarn run dev --port=8081
+```
+
+An HTTP server serving the local version of `todoblue` with hot-reload will become available on port `:8081`.