title	Release / Publish
description	How to bump versions, build, and publish packages to npm.

Release / Publish

This repo publishes packages to npm (scoped under @papyrus-sdk/*).

1) Bump versions

We use the built-in script to bump every package in packages/*:

pnpm bump:packages minor

Valid bumps: patch, minor, major.

Build packages only (skip examples) to avoid Vite/esbuild issues:

pnpm -r --filter ./packages/** build

If you want to build everything, use:

pnpm -r --workspace-concurrency=1 build

Note: examples/web can fail on Windows with Error: spawn EPERM (esbuild). If that happens, stick to the packages-only build.

Publishing requires a clean git tree unless you pass --no-git-checks.

git add .
git commit -m "release: bump packages to vX.Y.Z"

pnpm -r --filter ./packages/** publish --access public

If you intentionally publish from a dirty working tree:

pnpm -r --filter ./packages/** publish --access public --no-git-checks

Detects changes since origin/main (or BASE_REF) and publishes only those packages.

pnpm publish:changed

Build only:

pnpm build:changed

Override the base ref:

BASE_REF=main pnpm publish:changed