diff --git a/docs/DEVELOPMENT.md b/docs/DEVELOPMENT.md
index 0dda92a..5917d19 100644
--- a/docs/DEVELOPMENT.md
+++ b/docs/DEVELOPMENT.md
@@ -9,6 +9,7 @@ pgmorbac/
 ├── tools/                  # Build and test scripts
 ├── docs/                   # Documentation
 ├── pgmorbac.control       # Version source of truth
+├── index.js, index.d.ts   # npm package loader (@crudy/pgmorbac)
 ├── pgmorbac.sql          # Generated (git-ignored)
 └── Makefile               # Build automation
 ```
@@ -56,17 +57,33 @@ dropdb mytest
 
 ## Release Process
 
-1. Update version in `pgmorbac.control`
+1. `./tools/bump_version.sh X.Y.Z` (control file, META.json, package.json, README)
 2. Update `CHANGELOG.md`
 3. Run `make build` and `make check`
 4. Commit and tag:
 
 ```bash
-git commit -m "Release vX.Y.Z"
+git commit -am "release: X.Y.Z"
 git tag vX.Y.Z
 git push origin master --tags
 ```
 
+5. Signed SQL distribution, attached to the Gitea release (Drone does this on the
+   tag when the repository is activated there):
+
+```bash
+PGMORBAC_RELEASE_KEY=<path to the Ed25519 key> GITEA_URL=https://git.villains.fr \
+  GITEA_REPO=crudy/pgmorbac GITEA_TOKEN=<token> npm run release
+```
+
+6. npm package `@crudy/pgmorbac` (the SQL is built from `src/` on prepack). Publish
+   the same version to the local Verdaccio, for crudy development, and to npmjs:
+
+```bash
+npm publish --registry http://localhost:4873
+npm publish --registry https://registry.npmjs.org
+```
+
 ## Makefile Targets
 
 ```bash
diff --git a/tools/bump_version.sh b/tools/bump_version.sh
index a4769e6..e19d3d4 100755
--- a/tools/bump_version.sh
+++ b/tools/bump_version.sh
@@ -46,6 +46,11 @@ sed -i.bak \
     "$META_FILE"
 echo "  Updated $META_FILE"
 
+# --- package.json (the @crudy/pgmorbac npm package) ---
+PACKAGE_FILE="$ROOT_DIR/package.json"
+sed -i.bak "s/\"version\": \"$OLD_VERSION\"/\"version\": \"$NEW_VERSION\"/" "$PACKAGE_FILE"
+echo "  Updated $PACKAGE_FILE"
+
 # --- README.md (hardcoded version references in manual install section) ---
 sed -i.bak \
     -e "s/pgmorbac--$OLD_VERSION\.sql/pgmorbac--$NEW_VERSION.sql/g" \