Release-rutiner

Denne siden beskriver hele release-flyten for Impulse AI: fra feature branch til produksjon.

Oversikt

DB + API (tett koblet)

Feature branch → PR → CI Gate → main → Staging (auto) → /deploy-prod → Production

Komponent	Staging-deploy	Produksjons-deploy
API	Railway auto-deploy fra main	Railway auto-deploy fra production branch
Database	supabase db push via CI (auto)	supabase db push ved push til production

iOS (separat release-syklus)

fastlane ios bump → git tag v* → TestFlight (auto) → App Store (manuell promote)

Komponent	Staging-deploy	Produksjons-deploy
iOS	TestFlight via fastlane ios beta	App Store via fastlane ios promote

Web (uavhengig)

Komponent	Staging-deploy	Produksjons-deploy
Web	Vercel preview deploy (auto)	Vercel auto-deploy fra main

Railway-miljoer

Miljo	Branch	URL
Staging	main	api-stg.impulseai.app
Production	production	api.impulseai.app

CI Pipeline

CI kjoerer automatisk paa alle PR-er og push til main/develop. Kun endrede deler bygges.

Endring i	Jobb	Workflow	Kjoretid
packages/database/	db-check (migrasjoner + typer)	ci-backend.yml	~2 min
apps/api/ eller packages/shared/	api-check (lint + types + test + build)	ci-backend.yml	~1 min
apps/mobile-kmp/shared/ eller iosApp/	ios-preflight (KMP + Xcode build)	ci-ios.yml	~5 min
apps/mobile-kmp/shared/ eller androidApp/	android-preflight (KMP + Gradle)	ci-ios.yml	~3 min
Ingen match	Bare ci-gate/ios-gate (instant)	begge	~5 sek

CI Gate (ci-backend.yml) og iOS Gate (ci-ios.yml) er satt som required status checks i GitHub branch protection. Ingenting merges til main uten at begge passerer.

Release-syklus

Anbefalt ritme

Mandag-Torsdag: Utvikling
  Push → CI preflight (automatisk)
  PR → ci-gate maa passere foer merge

Fredag: Release DB + API
  1. Merge feature-branch → main
  2. CI passerer → Railway auto-deployer API til staging
  3. Database: staging-migrasjoner kjoeres automatisk
  4. Test staging
  5. /deploy-prod → promoter til production

Fredag: iOS-release (separat)
  6. fastlane ios bump type:patch → git tag → TestFlight
  7. Test i TestFlight over helgen

Mandag: Promoter iOS
  8. /promote → App Store

Versjonering

iOS-versjonen bumpes med Fastlane:

cd apps/mobile-kmp/iosApp

# Bump versjon
bundle exec fastlane ios bump type:patch  # 1.0.0 → 1.0.1
bundle exec fastlane ios bump type:minor  # 1.0.0 → 1.1.0
bundle exec fastlane ios bump type:major  # 1.0.0 → 2.0.0

# Push versjon + tag
git push && git push --tags

bump laner committer versjonsendringen og oppretter en git tag (v1.0.1).

iOS Release

3 ruter til TestFlight

Rute	Naar	Kommando
1. ios-release.yml (primaer)	Normal release med ny versjon	fastlane ios bump → git push --tags → ios-release.yml workflow_dispatch
2. Tag-trigger (automatisk)	Backup — trigger via deploy-production.yml	fastlane ios bump → git push --tags
3. Lokal build (noedloesning)	CI er nede, haster med hotfix	doppler run lokalt

Rute 1: ios-release.yml workflow_dispatch (anbefalt)

cd apps/mobile-kmp/iosApp

# 1. Bump versjon (committer + tagger automatisk)
bundle exec fastlane ios bump type:patch   # 1.0.0 → 1.0.1

# 2. Push commit og tag
git push && git push --tags

# 3. Trigger build via GitHub Actions
# Actions → "iOS Release" → Run workflow → lane: beta

Tips

ios-release.yml er primaer fordi deploy-production.yml tag-trigger kan misse hvis commits pushes til en annen branch samtidig. Bruk ios-release.yml workflow_dispatch for paalitelig trigger.

Hva som skjer i CI (ios-release.yml eller deploy-production.yml):

1. Job kjoerer paa macos-26 (Xcode 26, iOS 26 SDK)
2. Ruby gems installeres til $RUNNER_TEMP/bundle (unngaar at Xcode scanner vendor/)
3. Doppler henter secrets (DOPPLER_TOKEN_PRD)
4. fastlane ios beta kjoerer:
   • Signing: setup_ci → installerer WWDR G3-sertifikat → match appstore → update_code_signing_settings (Manual for app target)
   • Build number: Auto-inkrementerer fra TestFlight — ingen commit tilbake til main
   • KMP framework: kmp_release_framework bygger arm64 release og kopierer til baade xcode-frameworks/ og PBXGroup-path (iosSimulatorArm64/debugFramework)
   • Archive: Bygger med manual signing override + SUPPORTED_PLATFORMS=iphoneos (stripper iphonesimulator)
   • Upload: Laster opp til TestFlight

Rute 2: Tag-trigger (automatisk fallback)

Tag v* trigger ogsaa deploy-production.yml sin deploy-ios job. Men denne kan misse hvis andre commits pushes samtidig til en non-production branch.

Som backup kan du ogsaa bruke deploy-production.yml workflow_dispatch med target: ios.

Rute 3: Lokal build

cd apps/mobile-kmp/iosApp
doppler run --config prd -- bundle exec fastlane ios beta

Krever lokalt: Xcode 26, Match-sertifikater, Doppler CLI med tilgang til prd.

Forsiktig

Lokal build bor kun brukes som noedloesning. CI er foretrukket fordi den har konsistent miljo og reproducerbare builds.

App Store (promote)

Etter TestFlight-testing, promoter til App Store:

# Via GitHub Actions (anbefalt):
# Actions → "iOS Release" (ios-release.yml) → Run workflow → lane: promote

# Eller lokalt:
cd apps/mobile-kmp/iosApp
doppler run --config prd -- bundle exec fastlane ios promote

Forsiktig

promote sender IKKE inn for review automatisk. Du maa manuelt trykke “Submit for Review” i App Store Connect.

Produksjons-deploy (DB + API)

DB og API promoteres til production ved a pushe main til production-branchen:

# Via Claude Code (anbefalt):
/deploy-prod

# Manuelt:
git push origin main:production

Dette trigger:

• DB: supabase db push mot produksjons-Supabase
• API: Railway auto-deployer fra production-branchen

Tips

Git tags (v*) brukes naa kun til iOS-releases, ikke DB+API.

API Deploy

Staging

Railway staging overvaker main branch og auto-deployer. Ingen manuell handling noedvendig.

URL: api-stg.impulseai.app

Sikkerhet: Branch protection sikrer at ci-gate passerer foer merge til main — Railway deployer aldri broken kode.

Production

Railway production overvaker production branch og auto-deployer.

URL: api.impulseai.app

# Promoter staging til production:
/deploy-prod
# eller: git push origin main:production

Database-migrasjoner

Staging (automatisk)

Naar DB-endringer merges til main, kjoerer CI automatisk supabase db push mot staging-prosjektet.

Production

To alternativer:

Automatisk via git tag:

git tag v1.2.3 && git push --tags
# deploy-production.yml kjoerer supabase db push mot prod

Manuelt via GitHub Actions:

# Actions → "DB Deploy (manual)" → Run workflow
# 1. Velg environment: staging eller production
# 2. Velg action: dry-run (foerst!) eller migrate

Tips

Kjoer alltid dry-run foerst for aa se hvilke migrasjoner som vil bli kjort:

# Lokalt:
cd packages/database
supabase db push --dry-run

Migrasjon-workflow

1. Opprett migrering lokalt:
   pnpm db:migrate:new din_migrering

2. Skriv SQL i packages/database/supabase/migrations/

3. Test lokalt:
   pnpm db:reset

4. Generer TypeScript-typer:
   pnpm db:types

5. Commit og push → CI validerer

6. Merge til main → staging auto-deploy

7. Verifiser i staging → /deploy-prod → prod deploy

Web Deploy (Vercel)

Vercel deployer automatisk:

• Preview: Hver PR faar sin egen preview-URL
• Production: Auto-deploy fra main for landing (impulseai.app) og console (console.impulseai.app)

Ingen manuell handling noedvendig.

Rollback

Se Rollback-prosedyrer for detaljerte instruksjoner.

Hurtigreferanse:

Komponent	Rollback-metode	Tid
API	Railway: redeploy forrige versjon	~30 sek
Database	Ny migrering som reverser endringen	Minutter
iOS	Ikke mulig — push ny versjon	Timer/dager
Web	Vercel: instant rollback i dashboard	~5 sek

Fastlane-oversikt

Alle iOS-operasjoner gaar gjennom Fastlane. GitHub Actions er bare en tynn wrapper.

Lane	Jobb	Trigger
preflight	KMP compile + iOS simulator build	Automatisk (CI)
test	Kjoer iOS-tester	Manuelt
beta	sync_signing → auto build number → KMP release framework → archive (manual signing + iphoneos) → TestFlight	workflow_dispatch / git tag
promote	Siste TestFlight → App Store metadata	workflow_dispatch
release	Full: beta + App Store submit	workflow_dispatch
bump	Versjonering (patch/minor/major) + git tag	Manuelt (lokalt)
doctor	Sjekk toolchain	Manuelt

Lokal Fastlane-bruk

cd apps/mobile-kmp/iosApp

# Installer Ruby-deps (foerste gang):
bundle install

# Sjekk at alt fungerer:
bundle exec fastlane ios doctor

# Sjekk kompilering:
bundle exec fastlane ios preflight

GitHub Actions Workflows

Workflow	Fil	Trigger	Hva
CI Backend	ci-backend.yml	Push/PR til main	DB-check, api-check, CI Gate
CI iOS	ci-ios.yml	Push/PR til main	iOS preflight, iOS Gate
iOS Release	ios-release.yml	workflow_dispatch (lane: beta/promote/release)	Primaer iOS pipeline — macos-26 runner
Deploy Production	deploy-production.yml	Push til production ELLER workflow_dispatch	DB+API deploy kun — iOS er separat
DB Deploy	db-deploy.yml	Manuell	dry-run eller migrate mot staging/prod

Claude Code Slash Commands

Kommando	Hva den gjoer
/release ios patch	Safety checks → fastlane ios bump → push → trigger ios-release.yml beta
/release api	Safety checks → git push origin main:production → monitor deploy
/promote	Trigger ios-release.yml promote → App Store Connect
/deploy-prod	Push main → production branch (DB + API)
/deploy-status	Dashboard: CI, iOS release, production deploy status

Feilsoeking

”No signing certificate found"

bundle exec fastlane match appstore --force  # Regenerer sertifikater

"Build number already exists on TestFlight”

Build-nummeret auto-inkrementeres. Hvis det feiler, har du sannsynligvis et lokalt bygg med hoeyere nummer. Sjekk i App Store Connect.

Preflight feiler i CI

# Sjekk at Gradle wrapper er committert:
git ls-files apps/mobile-kmp/gradlew
# Skal vise filen. Hvis ikke: git add apps/mobile-kmp/gradlew

KMP-endringer kompilerer lokalt men ikke i CI

CI bruker cached Gradle. Push en tom commit eller vent til cache utloeper.

---

Nokkelrotasjon

Nar API-klientnokkelen (X-API-Key) ma byttes ut — ved mistanke om misbruk, teamendringer, eller rutinemessig.

Prosedyre

Steg	Handling	Verktoy
1	Generer ny nokkel	openssl rand -hex 32
2	Legg til ny nokkel	Doppler: API_CLIENT_KEY = gammel,ny
3	Deploy API	Railway resyncer automatisk
4	Oppdater Environment.kt	Bytt apiClientKey for riktig miljo
5	Ship app-oppdatering	fastlane ios beta
6	Sett minimum versjon	Doppler: MIN_APP_VERSION_IOS = X.Y.Z
7	Monitorer	Sjekk keyPrefix i Railway logs
8	Fjern gammel nokkel	Doppler: API_CLIENT_KEY = ny

Forsiktig

Steg 6 ma komme for steg 8. Appen ma tvinges til a oppdatere for gammel nokkel fjernes — ellers kan brukere med gammel app ikke na config-endepunktet for a lare at de ma oppdatere.

Frekvens

• Ved hendelse (lekkasje, misbruk): Umiddelbart
• Rutinemessig: Arlig er tilstrekkelig — noklene er ikke hemmelige (synlige i app-binary)

---

Force-update

Nar du ma tvinge brukere til a oppdatere appen — f.eks. ved nokkelrotasjon, breaking API-endringer, eller kritiske feilrettinger.

Aktivering

Sett minimum versjon i Doppler:

# Alle brukere pa iOS under v1.2.0 ser fullskjerm "Oppdater nå"
MIN_APP_VERSION_IOS=1.2.0

# Valgfritt: soft nudge for brukere under nyeste
LATEST_APP_VERSION_IOS=1.3.0

Railway resyncer automatisk — ingen deploy nodvendig.

Deaktivering

Sett tilbake til 0.0.0 eller fjern variabelen.

Brukeropplevelse

Situasjon	Resultat
App-versjon < MIN_APP_VERSION	Fullskjerm-blokk, kun “Oppdater nå”-knapp
App-versjon < LATEST_APP_VERSION	Dismissbar dialog med “Oppdater” / “Senere”
Config-kall feiler (nettverk)	Normal oppstart — aldri blokker pa feil