Quick Usage (Already Configured)
Patch release flow
- •Check the latest release tag and the commits since it.
- •Switch to the
devbranch and pull the latest from origin. - •Run
pnpm bump:patchto update:- •packages/app/package.json
- •packages/desktop/package.json
- •packages/desktop/src-tauri/tauri.conf.json
- •packages/desktop/src-tauri/Cargo.toml
- •Cargo.lock
- •Commit the version bump:
chore: bump version to X.Y.Z. - •Tag
vX.Y.Zand pushdevplus the tag to GitHub (triggers Release App). - •Draft release notes from the commit list since the last tag with a short title plus Highlights and Fixes.
- •If GitHub auto-created the release, edit it to use the human-readable notes.
Suggested commands
bash
git fetch --tags --prune git tag --list "v*" --sort=-v:refname | head -n 1 git log <last-tag>..HEAD --oneline git switch dev git pull --ff-only origin dev pnpm bump:patch git commit -am "chore: bump version to X.Y.Z" git tag vX.Y.Z git push origin dev --tags gh release edit vX.Y.Z --title "OpenWork vX.Y.Z" --notes-file release-notes.md
Common Gotchas
- •The release workflow auto-creates the GitHub release after tag push; edit it instead of creating a new one.
- •Make sure you are not in a detached HEAD before running the bump script.
First-Time Setup (If Not Configured)
- •Install dependencies with
pnpm install. - •Ensure
gh auth loginis complete so release edits succeed.