release-beta

Bump client and server package.json versions, commit, tag, and push beta releases.

37|6|Updated Oct 10, 2025
One-click install
npx skills add https://github.com/carrotwaxr/peek-stash-browser --skill release-beta-carrotwaxr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-beta
Source: https://github.com/carrotwaxr/peek-stash-browser/tree/main/.claude/skills/release-beta
Command: npx skills add https://github.com/carrotwaxr/peek-stash-browser --skill release-beta-carrotwaxr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Releasing a beta version requires carefully updating multiple package.json files, committing identical version strings, creating a correctly formatted tag, and pushing both commits and tags to the main branch; doing this manually is error-prone and can lead to mismatched versions or incorrect tags.

Core Features & Use Cases

  • Synchronized Versioning: Ensures client/package.json and server/package.json are updated to the exact same beta version string.
  • Automated Git Workflow: Guides the user to commit the version bump, push the changes to main, and create and push a v-prefixed tag that matches the version.
  • Use Case: Useful for maintainers who need a repeatable, consistent process to publish internal beta releases for QA or testers without introducing version drift or tagging mistakes.

Quick Start

Use the release-beta skill to bump both client and server package.json to the new X.Y.Z-beta.N, commit the changes, push to main, and create and push the matching v-prefixed beta tag.

Frequently Asked Questions about release-beta

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I bump and publish a beta release for a repo with separate client and server package.json files?

To publish a beta release for multiple package.json files, you update both version fields to an identical X.Y.Z-beta.N string, commit the changes on main, create a v-prefixed tag matching the version, and push commits and tags to origin.

Why do my beta releases end up with mismatched versions between client and server package.json files?

Mismatched beta versions occur when package.json files are updated manually. Automating the version bump ensures that both client and server package.json files receive the exact same beta version string before committing and tagging.

What is the correct git tag format for publishing an npm beta version?

The correct git tag format for a beta version is a v-prefixed tag that exactly matches the version string in your package.json, such as v1.2.3-beta.1, which must be pushed to origin along with the commit.

Can I use an automated git workflow to push beta tags directly to the main branch?

Yes, an automated git workflow can commit the version bump directly to the main branch, create the matching v-prefixed beta tag, and push both the commits and tags to origin for a consistent beta release process.

Do I need to manually tag a beta release if both package.json files are already updated?

Even if both package.json files are updated, you still need to commit the changes on main and create a v-prefixed tag matching the version to correctly publish the beta release, which can be fully automated to prevent tagging mistakes.