Publishing packages

Follow these steps to publish packages to Artifactory, our private npm registry. Before trying to publish, make sure you are authenticated with Artifactory:

npm adduser --registry=https://elmosoftware.jfrog.io/artifactory/api/npm/elmo-consolidated-npm/

Use your Artifactory username; for password you may need an API key from your Artifactory profile.

1. Pull the latest master branch.
2. Create a branch for the version changes.
3. Run pnpm run publish:version.
4. The version script will create a release notes markdown file, and update all packages to their new version.
5. Check the new release notes, and update with any desired changes. Run pnpm install to update pnpm-lock.yaml.
6. Check the updated versions and ensure they are as expected. There should never be a version < 4.0.0.
7. Commit the changes, push branch to Bitbucket and raise PR.
8. When PR is approved, merge your branch into master, and pull the latest master locally.
9. Run pnpm run publish:packages to publish the master branch to Artifactory.
10. Run git push --follow-tags to push the version tags to Bitbucket.
11. Deploy the docs site to staging and check it deployed successfully with the updated package docs.
12. Deploy the docs site to production to ensure the consumer docs site matches what has been published.