DEVELOPERS.md

Building and Testing this project

This document describes how to set up your development environment to build and test this project. It also explains the basic mechanics of using git and node

• Prerequisite Software
• Project Organisation
• Installing NPM Modules
• Running Tests
• Formatting your Source Code
• Linting/verifying your Source Code
• Semantic Release setup

See the contribution guidelines if you'd like to contribute to this project.

Prerequisite Software

Before you can build and test this project, you must install and configure the following products on your development machine:

• Git and/or the GitHub app (for Mac or Windows); GitHub's Guide to Installing Git is a good source of information.

• Node.js, (version specified in the engines field of package.json) which is used to run tests.

Project organisation

The project is organised into the following folder structure:

• / - Project-level configuration (linting rules, CI, docs, license)
• src/ - The source code and test specifications

Installing

# Install the dependencies & devDependencies
npm install

Formatting your source code

This project uses eslint and prettier to format the source code. If the source code is not properly formatted, the CI will fail and the PR cannot be merged.

You can automatically format your code by running:

• npm run lint: format all source code

A better way is to set up your IDE to format the changed file on each file save.

WebStorm / IntelliJ

1. Open Preferences > Languages & Frameworks > JavaScript > Prettier
2. Find the field named "Prettier Package"
3. Add <PATH_TO_YOUR_WORKSPACE>/<project-root>/packages/web-app/node_modules/prettier

Linting/Verifying your Source Code

You can check that your code is properly formatted and adheres to coding style:

# Check that the code is formatted and following the coding style:
npm run verify

# Fix any auto-fixable errors
npm run lint

Semantic Release Setup

This section is include for informational purposes only.

This repo uses [semantic-release][semantic-release] to manage software versions and packaging. There is a one-time setup-step required - WHICH HAS ALREADY BEEN DONE, which creates a GitHub personal access token, an NPM token, and connects them to Travis CI.

One time setup:

cd this-project-repo
npx semantic-release-cli setup

? What is your npm registry? https://registry.npmjs.org/
? What is your npm username? u_glow
? What is your npm password? [hidden]
? Provide a GitHub Personal Access Token (create a token at https://github.com/settings/tokens/new?scopes=repo) xxxxxxxxxxxxxxxxxxxxxxx
? What CI are you using? Github Actions

---