This project requires NodeJS (version 18 or later) and NPM. Node and NPM are really easy to install. To make sure you have them available on your machine, try running the following command.
$ npm -v && node -v
6.4.1
v8.16.0
The project uses npm to manage package dependencies. To install dependencies locally run the following from your preferred shell:
$ npm install
Environment variables are set in a .env
file and should match the .env.template
file. Currently the only variables that needs to be set are FRONTEND_URL
and BACKEND_URL
. This can be localhost for local development. It is updated by ansible when provisioning VMs.
Once the all dependencies have been installed, start the React app in development mode by running:
$ npm run dev
You should see output similar to the following:
> [email protected] dev
> npm-run-all --parallel dev:*
> [email protected] dev:css
> npx tailwindcss -i ./src/index.css -o ./public/index.css --minify --watch
> [email protected] dev:esbuild
> node build/server.mjs
frontend running on http://127.0.0.1:8080
Rebuilding...
Done in 159ms.
If the backend is running you should be able to access the site at http://localhost:8080