Release Process

First-time Setup

1. Generate Personal Github token (Settings -> Developer Settings -> Personal Access Tokens)

2. Add token to path/env as GITHUB_TOKEN

3. Set up account at npmjs.com and request invite to Datawheel org

4. Login to your local npm instance using npm login

Release

1. Navigate in your terminal to the top-level folder of your node package (the one that contains package.json)

2. Make sure your local repo is on the master branch (git checkout master) and is up to date (git pull origin master)

3. Increment the version number in package.json. Save the file but do not commit nor push it.

4. If the version bump is Semantic Minor or greater (x or y in x.y.z), also update the peerDependencies and devDependencies of all other packages to match the new x.y. For example, if updating canon-core to 0.21.x, canon-cms package.json should respect that:

"devDependencies": {
  "@datawheel/canon-core": "workspace:^0.21.0",
  "@datawheel/canon-logiclayer": "workspace:^0.5.0"
}

5. Run pnpm run release [package-name, e.g., cms]