From 8e6dbb6b2450703a825091a6947d6ace9e84f6f1 Mon Sep 17 00:00:00 2001
From: Ole-Morten Duesund <olemd@glemt.net>
Date: Mon, 23 Mar 2026 15:30:24 +0100
Subject: [PATCH] Dokumenter utgivelsesprosess med PWA-distribusjon
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Legger til Release Process-seksjon i CLAUDE.md med:
- Steg-for-steg for å lage ny utgivelse
- Bygging av Android APK-er og PWA-tarball
- fj release create og fj release asset create syntaks
- Oppdatert Distribution-seksjon med PWA-tarball

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 CLAUDE.md | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index a5b4d4d..df4f859 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -58,10 +58,26 @@ no.naiv.tilfluktsrom/
 - **fdroid**: AOSP-only, no Google dependencies
 
 ## Distribution
-- **Forgejo** (primary): `kode.naiv.no/olemd/tilfluktsrom` — releases with both APK variants
+- **Forgejo** (primary): `kode.naiv.no/olemd/tilfluktsrom` — releases with both APK variants + PWA tarball
 - **GitHub** (mirror): `github.com/olemd/tilfluktsrom` — automatically mirrored from Forgejo, do not push manually
 - **F-Droid**: Metadata maintained in a separate fdroiddata repo (GitLab fork). F-Droid builds from source using the `fdroid` variant and signs with the F-Droid key.
 
+## Release Process
+When creating a new release:
+1. Bump `versionCode` and `versionName` in `app/build.gradle.kts`
+2. Update User-Agent string in `ShelterRepository.kt` to match new version
+3. Build Android APKs: `./gradlew assembleStandardRelease assembleFdroidRelease`
+4. Build PWA: `cd pwa && bun scripts/fetch-shelters.ts && bun run build && tar -czf /tmp/tilfluktsrom-vX.Y.Z-pwa.tar.gz -C dist .`
+5. Commit, push, then create Forgejo release with all three artifacts:
+   ```bash
+   fj release create --create-tag vX.Y.Z --branch main \
+     --attach "/tmp/tilfluktsrom-vX.Y.Z-standard.apk:tilfluktsrom-vX.Y.Z-standard.apk" \
+     --attach "/tmp/tilfluktsrom-vX.Y.Z-fdroid.apk:tilfluktsrom-vX.Y.Z-fdroid.apk" \
+     --body "release notes" "vX.Y.Z"
+   fj release asset create vX.Y.Z /tmp/tilfluktsrom-vX.Y.Z-pwa.tar.gz tilfluktsrom-vX.Y.Z-pwa.tar.gz
+   ```
+6. Install on phone: `adb install -r app/build/outputs/apk/standard/release/app-standard-release.apk`
+
 ## Screenshots
 
 Use the Android emulator and Maestro to take screenshots for the README and fastlane metadata.