Maintainers

This document is for project maintainers who are doing versioning, releases, and publishing for the cardstack mono-repo.

Updating package versions (with safeguards)

The versions of all packages in the mono-repo are updated at the same time, to the same version number.

Get the latest code on main: git checkout main, git pull origin main
Make sure your history is clean with git status
Look at the git log since the last release, and list anything significant in the CHANGELOG.md. Determine whether the release should be a major (breaking), minor, or patch. For breaking releases, include upgrade instructions in the changelog. Commit your changes.
Update all package versions, publish to npm, and push to GitHub with this command: npx lerna publish --force-publish="*" --exact
Check to see that the new version is on GitHub and on npm

If you are very confident in what you are doing, you can accomplish all of the above by running this command from an up-to-date version of main.

npx lerna publish --force-publish="*" --exact

Always make sure you are publishing from an up-to-date copy of main. You don't want to publish stale code!
New packages may need some additional configuration before they can be published
If you have problems, check the version of lerna you are using. There may be new features in the lerna docs that are more recent than our version. Always use npx and not a globally installed version of lerna, for consistency.