Dorkroom release and versioning workflow — CalVer version bumps across package.json files, changelog entries, and which app (web vs iOS) versions independently. Use when pushing to main, cutting a release, bumping versions, or adding a changelog entry.
Installs into .claude/skills of the current project.
Are you the author of Releasing?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/narrowstacks-releasing)
---
name: releasing
description: Dorkroom release and versioning workflow — CalVer version bumps across package.json files, changelog entries, and which app (web vs iOS) versions independently. Use when pushing to main, cutting a release, bumping versions, or adding a changelog entry.
---
# Releasing Dorkroom
## Versioning
- **CalVer** (`YYYY.MM.DD`) — all `package.json` versions use the date changes are pushed to main.
- When pushing to main, update all `package.json` versions to the current date.
- The README version badge (and the React/Tailwind/TypeScript badges) are auto-synced from
`package.json` by the `Sync README Badges` workflow — **do not hand-edit them**.
- The homepage screenshot in the README is auto-regenerated by the `Homepage Screenshot` workflow.
## Changelog
Add a new entry summarizing what changed, using [Keep a Changelog](https://keepachangelog.com/)
format, to the changelog for the app you touched:
| App | Changelog | Version source |
| ------- | ------------------------ | --------------------------- |
| Web app | root `CHANGELOG.md` | root `package.json` |
| iOS app | `apps/mobile/CHANGELOG.md` | `apps/mobile/package.json` |
The two apps version **independently**.
