ocadotechnology / codeforlife-package-javascript

codeforlife-package-javascript

This repo hosts Code for Life's Node.js package. This package contains all reusable frontend code, meant to be installed across CFL's various frontend services.

Installation

To install this package, do one of the following options.

Remember to replace the version number ("0.0.0") with your desired version.

Option 1: Run yarn install command:

yarn install git+https://github.com/ocadotechnology/codeforlife-package-javascript.git#v0.0.0

Option 2: add the following to package.json:

{
  "dependencies": {
    "codeforlife": "github:ocadotechnology/codeforlife-package-javascript#v0.0.0"
  }
}

Making Changes

To make changes, you must:

1. Branch off of main.
2. Push your changes on your branch.
3. Ensure the pipeline runs successfully on your branch.
4. Have your changes reviewed and approved by a peer.
5. Merge your branch into the main branch.
6. Manually trigger the Main pipeline for the main branch.

Installing your branch

You may wish to install and integrate your changes into a CFL frontend before it's been peer-reviewed.

Remember to replace the branch name ("my-branch") with your branch.

{
  "dependencies": {
    "codeforlife": "github:ocadotechnology/codeforlife-package-javascript#my-branch"
  }
}

Pipeline

When pushing to any branch, the pipeline will:

1. Check the code for linting errors.
2. Run tests on the React components.
3. Build the package.
4. Save the build to the lib directory.

When merging to the main branch, the pipeline will:

1. Update the package version in package.json.
2. Update CHANGELOG.md with latest commit messages.
3. Determine the next version number from the commit messages using semantic versioning.
4. Release a new version on GitHub.