pubm-plugin

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

• Quick Start
• Configuration
• Changesets
• Monorepo
• CI/CD
• CLI Reference
• Plugins API

FAQ