Steve-Dee-Designs
/
woocommerce
mirror of https://github.com/woocommerce/woocommerce.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
woocommerce/tools/package-release
History
Christopher Allford 67cde87fd1
Enforce Strict `@types` Dependencies (#37351) 		2023-03-23 18:02:20 -07:00
..
bin Package release script: Prepare packages (#33515) 2022-06-23 12:09:43 +12:00
src Update the @woocommerce/eslint-plugin and fix bugs (#36988) 2023-03-02 11:36:38 +13: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 Package Release: handle initial release case (#36922) 2023-02-28 09:36:38 +13:00
package.json Enforce Strict `@types` Dependencies (#37351) 2023-03-23 18:02:20 -07: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.

Release packages using Github Workflows (recommended)

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

When making an initial release for a new package, pass the --initialRelease flag to signify a new release for a new package.

  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.