Auto-derive version and build number from git tag

Previously, version numbers had to be manually updated in four places
in the Xcode project before each release, which was error-prone and
often got out of sync with git tags.

Now the archive scripts automatically set:
- MARKETING_VERSION from git tag (v0.0.8 → 0.0.8)
- CURRENT_PROJECT_VERSION from git commit count (unique per build)

The git tag is now the single source of truth for versioning.

Author: bartTC

CHANGELOG.md

@@ -7,6 +7,7 @@ All notable changes to this project will be documented in this file.
 ### Changed
 - Release scripts now use shared `config.sh` for app name and paths
 - `just release` no longer waits for notarization (async workflow)
+- Version and build number now auto-derived from git tag and commit count
 
 ## [v0.0.8] - 2026-01-07
 

RELEASE.md

@@ -205,13 +205,15 @@ Both require the private key to be present.
 
 Before releasing a new version:
 
-1. [ ] Update version in Xcode (both targets)
-2. [ ] Update `CHANGELOG.md`
-3. [ ] Create git tag: `git tag v0.0.X`
-4. [ ] Push tag: `git push origin v0.0.X`
-5. [ ] Build releases:
+1. [ ] Update `CHANGELOG.md`
+2. [ ] Create git tag: `git tag v0.0.X`
+3. [ ] Push tag: `git push origin v0.0.X`
+4. [ ] Build releases:
    - [ ] `just release v0.0.X` (direct)
    - [ ] `just dmg v0.0.X` (optional DMG installer)
    - [ ] `just release-appstore v0.0.X` (App Store)
-6. [ ] Create GitHub release with `.zip` (and optionally `.dmg`)
-7. [ ] Submit App Store version in App Store Connect
+5. [ ] Create GitHub release with `.zip` (and optionally `.dmg`)
+6. [ ] Submit App Store version in App Store Connect
+
+> **Note:** Version and build number are automatically set from the git tag.
+> `v0.0.8` → MARKETING_VERSION=0.0.8, BUILD=(commit count)

scripts/archive-appstore.sh

@@ -37,6 +37,17 @@ trap cleanup EXIT
 
 echo "Building for App Store: $ver"
 
+# Derive marketing version and build number from git
+marketing_version="${ver#v}"  # v0.0.8 → 0.0.8
+build_number=$(git rev-list --count HEAD)
+
+echo "Setting MARKETING_VERSION=$marketing_version, BUILD=$build_number"
+
+# Update Xcode project with version info
+project_file="$PROJECT/project.pbxproj"
+sed -i '' "s/MARKETING_VERSION = [^;]*;/MARKETING_VERSION = $marketing_version;/g" "$project_file"
+sed -i '' "s/CURRENT_PROJECT_VERSION = [^;]*;/CURRENT_PROJECT_VERSION = $build_number;/g" "$project_file"
+
 ver_dir="$BUILD_DIR/$ver-appstore"
 archive_path="$ver_dir/CacheStatus.xcarchive"
 export_path="$ver_dir/export"

scripts/archive.sh

@@ -38,6 +38,17 @@ trap cleanup EXIT
 
 echo "Building version: $ver"
 
+# Derive marketing version and build number from git
+marketing_version="${ver#v}"  # v0.0.8 → 0.0.8
+build_number=$(git rev-list --count HEAD)
+
+echo "Setting MARKETING_VERSION=$marketing_version, BUILD=$build_number"
+
+# Update Xcode project with version info
+project_file="$PROJECT/project.pbxproj"
+sed -i '' "s/MARKETING_VERSION = [^;]*;/MARKETING_VERSION = $marketing_version;/g" "$project_file"
+sed -i '' "s/CURRENT_PROJECT_VERSION = [^;]*;/CURRENT_PROJECT_VERSION = $build_number;/g" "$project_file"
+
 ver_dir="$BUILD_DIR/$ver"
 archive_path="$ver_dir/CacheStatus.xcarchive"
 export_path="$ver_dir/export"