woocommerce/tools/package-release
Joshua T Flowers 3fd736c72f
Update plugins installer component to TS, Fix TS bugs and Syncpack TypeScript (#34787)
2022-09-30 10:59:07 +13:00
..
bin Package release script: Prepare packages (#33515) 2022-06-23 12:09:43 +12:00
src Packages Release: Add manual workflow (#33922) 2022-07-22 12:08:11 +12:00
.eslintignore Package release script: Prepare packages (#33515) 2022-06-23 12:09:43 +12:00
.eslintrc Package release script: Prepare packages (#33515) 2022-06-23 12:09:43 +12:00
.gitignore Package release script: Prepare packages (#33515) 2022-06-23 12:09:43 +12:00
README.md Packages Release: Add manual workflow (#33922) 2022-07-22 12:08:11 +12:00
package.json Update plugins installer component to TS, Fix TS bugs and Syncpack TypeScript (#34787) 2022-09-30 10:59:07 +13:00
tsconfig.json Improve experimental select control accessibility (#34510) 2022-09-20 14:29:27 -07:00

README.md

Releasing Javascript packages

When a package contains sufficient changes to justify a release to NPM, follow these instructions to create a new release from the monorepo.

Prepare packages

In order to prepare a package for release, a changelog will need to be compiled along with an appropriate version bump.

  1. Visit the monorepo Action Prepare Package Release workflow. Click the "Run workflow" button.

image

  1. Select the branch you'd like to release from. Typically, this would be trunk. You can also choose which packages to prepare for release by supplying them as comma separated values in the input box. To loop through all packages, simply leave the -a flag. Packages that don't have any changes will be skipped and left as is.

image

  1. Once the action has finished, check open pull requests for a pull request generated by Github Actions Bot. This pull request should include version bumps and changelog changes for applicable packages. Approve and merge the pull request once checks pass.

Release Packages

  1. Release the packages to NPM by kicking off another workflow. The Packages Release workflow has the same inputs as the prepare workflow. Be sure to release from the same branch and select the same packages to release.

image

  1. Confirm the package has been updated by visiting NPM. For example see https://www.npmjs.com/package/@woocommerce/components.

Release packages using the command line

Prepare packages

  1. At monorepo root, run the following command to prepare all packages. Instead of the -a flag, you can pass in a list of packages separated by commas.
./tools/package-release/bin/dev prepare -a
  1. Create a pull request with the resulting changes and merge it.

See more about the prepare script using ./tools/package-release/bin/dev publish --help.

Release Packages

  1. Pull down the latest commits from Github.

  2. Run the release script from monorepo root, first as a dry run.

./tools/package-release/bin/dev publish -a --dry-run
  1. Run the release for real this time.
./tools/package-release/bin/dev publish -a

See more about the publish script using ./tools/package-release/bin/dev publish --help.