pubm
One command. Every registry.
Publish to npm, jsr, crates.io, and private registries in one step.
If anything fails, pubm undoes the version bump, tag, and commit automatically.
English ·
한국어 ·
简体中文 ·
Français ·
Deutsch ·
Español
Why pubm?
Most release tools assume one registry. pubm is built for projects that grow:
- npm + jsr - ship to both JavaScript registries in one command
- JS + Rust - publish
package.json and Cargo.toml in a single pipeline
- Monorepos - publishes packages in dependency order, no manual sequencing
- Automatic rollback - if any registry fails, pubm undoes the version bump, tag, and commit (registry unpublish is best-effort - version numbers may be permanently reserved)
- Zero config - registries are auto-detected from your manifest files
- Conventional commit support - falls back to commit history for packages without a changeset, using
feat/fix/perf/refactor type → bump mapping
Start with npm only. Add jsr next month. Move to a monorepo next year. Your release command stays the same: pubm.
If you only publish one package to npm, np or release-it will serve you fine. pubm is for when you don't want to redo your release setup every time your project grows.
How it works
Zero config
pubm reads your manifest files and figures out the registries:
| Manifest | Registry |
|---|
package.json | npm |
jsr.json | jsr |
deno.json / deno.jsonc | jsr |
Cargo.toml | crates.io |
Have both package.json and jsr.json? pubm publishes to both in one release. No config needed.
Automatic rollback
Registry rejected your package? pubm undoes the version bump, git tag, and commit. Note: registry unpublish is best-effort - npm reserves the version number even after unpublish, so you may need to bump to a new version.
Preflight checks
Branch, working tree, remote sync, login status, publish permissions - all verified before pubm touches anything. In CI mode, pubm validates tokens and runs publish dry-runs to catch issues before the real publish:
pubm --mode ci --phase prepare
Same command, local and CI
Interactive prompts in your terminal, fully headless in CI. No separate config, no flags to remember.
Monorepo-native
Detects pnpm, yarn, npm, bun, deno, and Cargo workspaces automatically. Publishes in dependency order. Supports independent versioning, fixed versioning, and linked groups.
Multi-ecosystem
JavaScript and Rust in the same pipeline. Mixed JS + Rust workspaces work out of the box.
Multilingual CLI
Prompts, errors, task progress, rollback instructions: all translated into 6 languages.
English · 한국어 · 简体中文 · Français · Deutsch · Español
pubm picks up your system locale automatically. You can also set it yourself:
# CLI flag
pubm --locale ko
# Environment variable
PUBM_LOCALE=fr pubm
# Or set it in pubm.config.ts
export default defineConfig({ locale: "zh-cn" });
Quick Start
# npm
npm i -g pubm
# Homebrew
brew tap syi0808/pubm
brew install pubm
# Interactive setup wizard - detects packages, configures registries, CI, and more
pubm init
# Just run pubm - that's it
pubm
# Publish a snapshot release with a custom tag (useful for testing pre-releases)
pubm snapshot [tag]
# Optional: install coding agent skills (Claude Code, Codex, Gemini)
pubm setup-skills
That's it. pubm walks you through the rest:
$ pubm
│
├─ Pick a version ── patch, minor, or major
├─ Preflight checks ── branch, working tree, remote sync
├─ Registry validation ── auth, permissions, availability
├─ Test & Build ── runs your npm scripts
├─ Version bump ── updates manifests, creates git commit + tag
├─ Publish ── all registries at once
├─ Post-publish ── pushes tags, creates GitHub Release
│
└─ On failure → rolls back everything
Documentation
FAQ