Release Skill

Create versioned releases with CalVer versioning and GitHub binary distribution.

Quick Release

GITHUB_TOKEN=$(gh auth token) bun run release --ci

The --ci flag runs non-interactively (no prompts). This command:

1. •Runs typecheck and lint checks
2. •Builds the project
3. •Bumps version (CalVer: YYYY.MM.PATCH)
4. •Creates git tag and commit
5. •Creates draft GitHub release (triggers binary builds)

Important: The release is created as a draft. GitHub Actions will build binaries for all platforms and then publish the release. Wait ~2-3 minutes for binaries to be available.

Version Format

CalVer format: YYYY.MM.PATCH

Examples:

• •2026.1.0 - First release in January 2026
• •2026.1.1 - Second release in January 2026
• •2026.2.0 - First release in February 2026

GitHub Actions Build

On tag push (v*), the release workflow automatically:

1. •

   Builds for all platforms:

   • •darwin-arm64 (Apple Silicon Mac)
   • •darwin-x64 (Intel Mac)
   • •linux-x64 (Linux)
   • •linux-arm64 (Linux ARM)
   • •win32-x64 (Windows)
2. •

   Packages each platform:

   • •Minified JS bundle
   • •Sharp native modules
   • •~8MB compressed per platform
3. •

   Publishes GitHub Release:

   • •Uploads all platform archives to the draft release
   • •Publishes the release (removes draft status)

Manual Steps After Release

1. •

   Verify GitHub Actions completed:

   bash

   gh run list --limit 5
   

2. •

   Check release assets:

   bash

   gh release view v$(cat package.json | jq -r .version)
   

3. •

   Test installation:

   bash

   curl -fsSL https://raw.githubusercontent.com/guillempuche/appicons/main/scripts/install.sh | bash
   appicons --version
   

Troubleshooting

Build Fails on a Platform

Check the specific job in GitHub Actions:

gh run view --log-failed

Missing Release Assets

Re-run failed jobs:

gh run rerun <run-id> --failed

Version Mismatch

If local version differs from remote:

git fetch --tags
git describe --tags --abbrev=0