cemtrik-dependencies 1.1.0 → 1.1.2

package/README.md

@@ -266,6 +266,53 @@ Storybook scripts live in `storybook/package.json`:
 | `npm run generate-docs` | Generate Storybook docs |
 | `npm run deploy` | Deploy Storybook to Firebase hosting |
 
+## Publishing
+
+Use this flow to publish a new version of the package safely from the repository root.
+
+### 1. Confirm access
+
+```bash
+npm whoami
+```
+
+If npm requires 2FA for publishing, use a granular access token with `Bypass two-factor authentication` enabled and configure it locally for the session.
+
+### 2. Verify the release candidate
+
+```bash
+npm run lint
+npm test -- --runInBand
+npm run build
+npm publish --dry-run
+```
+
+### 3. Bump the version
+
+Use semantic versioning intentionally:
+
+- `npm version patch` for bug fixes and non-breaking changes
+- `npm version minor` for new backward-compatible features
+- `npm version major` for breaking changes
+
+### 4. Publish
+
+```bash
+npm publish
+```
+
+### 5. Verify on npm
+
+Confirm the new version on the package page:
+
+https://www.npmjs.com/package/cemtrik-dependencies
+
+Notes:
+
+- Do not run `npm version` more than once for the same release.
+- The published tarball comes from `dist/` only.
+- Do not commit npm tokens or store them in the repository.
+
 ## License
 
 Copyright 2024 Cemtrik. All rights reserved.