@sandbox-technologies/release-kit
v0.5.31
Published
ReleaseKit CLI for managed desktop release candidates.
Readme
ReleaseKit
Hosted desktop releases from the command line.
GitHub stores source. ReleaseKit builds, signs, stores, approves, promotes, and rolls back releases.
npm install -g @sandbox-technologies/release-kit
release-kit login
release-kit previewBuild steps live in release-kit.yml. Managed builds require that file; ReleaseKit does not choose your app's install or build commands. There is no workflow file, GitHub environment, or publish target to choose.
Commands
| Command | What it does |
| --- | --- |
| release-kit login | Sign in with your ReleaseKit dashboard account |
| release-kit select | Choose the active project |
| release-kit preview | Build artifacts for the current branch |
| release-kit publish production | Create a gated candidate for the stable feed |
| release-kit publish nightly | Create a gated candidate for the nightly feed |
| release-kit update | Update the ReleaseKit CLI to the latest npm version |
| release-kit doctor | Check local CLI wiring |
release-kit update runs npm install -g @sandbox-technologies/release-kit@latest
and leaves future release-kit invocations on the latest published CLI.
Production asks for a patch, minor, or major bump unless you pass --patch,
--minor, or --major. Nightly creates a nightly prerelease version. Both
lanes ask ReleaseKit cloud to update the configured app version files, commit
that bump, push it, and create the candidate from the pushed commit.
Do not pass --version to managed publishes. ReleaseKit owns version selection
so the cloud build, version commit, candidate, and lane baseline stay in sync.
CI
For automation, create a ReleaseKit project API key and expose it as:
RELEASE_KIT_TOKEN=rk_live_...Lanes
Every project has exactly three lanes:
| Lane | Channel/feed | Behavior |
| --- | --- | --- |
| Production | stable | Gated final release feed |
| Nightly | nightly | Gated prerelease feed |
| Preview | internal | Branch artifacts only |
Production and Nightly are separate feeds. Publishing or promoting Nightly
changes only nightly; publishing or promoting Production changes only
stable. Both require ReleaseKit approval before their feed changes. Preview
creates artifacts for inspection and does not publish a user-facing feed.
Documentation
Product docs live at release-kit.dev/docs.
