You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: PUBLISH.md
+10-4
Original file line number
Diff line number
Diff line change
@@ -3,6 +3,8 @@
3
3
**We use the `xyz` NPM package to simplify releases. This library uses a feature that is available in Bash 4 or beyond, but latest versions of macOS
4
4
ship with an older version of Bash. If you run into issues with `xyz`, use `brew install bash` to install a newer verison of Bash.**
5
5
6
+
If you run into any `npm` package versioning issues, make sure you run `make setup` rather than calling `npm install` directly.
7
+
6
8
1. Create a branch to stage the release, for example `release-3.4.5` (Read [semver](https://semver.org/) to determine what type of version bump to use.)
7
9
8
10
```
@@ -25,16 +27,20 @@ make release-(patch|minor|major)
25
27
26
28
5. Merge the branch
27
29
28
-
#### **Manually publish to NPM**
30
+
#### **If the `make` command errors out with an authentication issue**
29
31
30
32
If `make release-*` from above errors out with an authentication issue,
31
33
you may need to `npm login` or otherwise manually set up your `~/.npmrc` file to
32
34
make sure you have access to publish to npm.
33
35
34
-
Once you have done that, the following command will publish the latest version
35
-
(already bumped and pushed in step 4) to the NPM registry:
36
+
#### (dangerous) Manually publish an already-built package to npm
37
+
38
+
If you've set up your npm authentication as described above, but are still seeing authentication issues when running `make release-*`, you can
39
+
directly publish a **built** package to the npm registry using the manual commands below. You should **only** publish the package manually using these steps
40
+
if the build steps of the `make release-*` command were **successful**. If the build steps did not succeeed, running these commands could publish an unbuilt
41
+
version of the package, which would lead to a broken release.
0 commit comments