Lokalt utviklingsmiljo

Denne guiden dekker alt du trenger for a sette opp et komplett lokalt utviklingsmiljo for Impulse AI, inkludert backend, database og iOS/KMP-utvikling.

Forutsetninger

Installer folgende verktoy for du starter:

Verktoy	Versjon	Installasjon
Node.js	22+	brew install node@22
pnpm	9+	npm install -g pnpm
Docker Desktop	Nyeste	docker.com
Xcode	16+	Mac App Store (for iOS-utvikling)
JDK	17	brew install openjdk@17
Doppler CLI	Nyeste	brew install dopplerhq/cli/doppler
Supabase CLI	Nyeste	brew install supabase/tap/supabase
GitHub CLI	Nyeste	brew install gh

aside.caution

Docker Desktop ma kjore for du starter lokale tjenester. Verifiser med docker info.

Klone og installer

# 1. Klone repoet
git clone git@github.com:<org>/im.git
cd im

# 2. Installer avhengigheter
pnpm install

Doppler-oppsett (hemmeligheter)

Impulse AI bruker Doppler for a haandtere hemmeligheter og miljovaribler. Ingen .env-filer commites.

# 1. Logg inn i Doppler
doppler login

# 2. Koble til prosjektet (i repo-roten)
doppler setup
# Velg prosjekt: im
# Velg config: dev

Etter oppsett kjorer du alle kommandoer gjennom Doppler:

# Start utvikling med injiserte hemmeligheter
doppler run -- pnpm dev

# Eller start kun API
doppler run -- pnpm --filter api dev

aside.tip

Hvis du trenger a se hvilke hemmeligheter som er konfigurert:

doppler secrets

Start lokale tjenester

Impulse AI bruker Supabase (PostgreSQL + Auth) og Redis lokalt via Docker.

# Start Docker-containere (Supabase + Redis)
pnpm docker:start

# Verifiser at alt kjorer
pnpm db:status
pnpm docker:verify

Forste gangs oppsett

# Kjor alle migrasjoner og seed-data
pnpm db:reset

# Generer TypeScript-typer fra databaseskjema
pnpm db:types

Kjor utvikling

# Start alle apper (API + web)
doppler run -- pnpm dev

# Eller start kun det du trenger
doppler run -- pnpm --filter api dev        # Kun API
doppler run -- pnpm --filter @im/console dev  # Kun Console
doppler run -- pnpm --filter @im/landing dev  # Kun Landing

Portliste

Port	Tjeneste	Beskrivelse
3001	API (Fastify)	Backend API-server
3003	Landing	Offentlig nettside
3004	Console	Intern kontrollrom
5173	Docs (Starlight)	Denne dokumentasjonen
54323	Supabase Studio	Databaseadministrasjon (GUI)
54332	PostgreSQL	Databasetilkobling
6380	Redis	Cache og jobbkoer

aside.caution

Ikke start testservere pa port 3000 eller 3001 — disse portene brukes av det lokale kjoremiljoet for manuell testing i nettleseren.

Dev API token (auth bypass)

For raskere testing av API-et uten autentisering:

# 1. Generer en dev-token
openssl rand -hex 32

# 2. Legg til i Doppler (dev config) eller apps/api/.env.local
# DEV_API_TOKEN=din-genererte-token

# 3. Bruk i API-kall
curl -H "X-Dev-Token: din-genererte-token" http://localhost:3001/api/v1/impulses

Tilgjengelige testbrukere (fra seed.sql):

Tier	User ID	E-post
trial	11111111-1111-1111-1111-111111111111	trial@test.rm
foundation	22222222-2222-2222-2222-222222222222	foundation@test.rm
mastery	33333333-3333-3333-3333-333333333333	mastery@test.rm
partner	44444444-4444-4444-4444-444444444444	partner@test.rm

Du kan spesifisere bruker-tier med header:

curl -H "X-Dev-Token: token" -H "X-Dev-User-Tier: trial" http://localhost:3001/api/v1/impulses

aside.note

Dev-token fungerer kun nar DEV_API_TOKEN er satt og NODE_ENV ikke er production.

KMP/iOS-utvikling med Cursor

iOS-appen kan utvikles i Cursor (eller VS Code) uten a apne Xcode GUI, ved hjelp av Sweetpad og xcode-build-server.

Installer Homebrew-verktoy

# LSP utenfor Xcode (autocomplete, jump to definition)
brew install xcode-build-server

# Pen output fra xcodebuild
brew install xcbeautify

# Swift-formattering (valgfritt)
brew install swiftformat

Installer Cursor-extensions

Apne Cursor, ga til Extensions (CMD+SHIFT+X):

1. Swift (sswg.swift-lang) — syntax highlighting og Swift-stotte
2. Sweetpad (sweetpad.hyzyla.dev) — bygg, kjor og administrer schemes fra Cursor

Generer Build Server Config

1. Apne repo-roten (im/) i Cursor
2. CMD+SHIFT+P -> "Sweetpad: Generate Build Server Config"
3. Bygg minst en gang (neste steg) for at LSP skal fungere

Bygg og kjor

1. Pin Sweetpad-panelet i sidebaren
2. Velg target "iosApp" og destination (simulator/enhet)
3. CMD+SHIFT+B = Build & Run

Endring	Oppdatering
Swift-filer	Full build (CMD+SHIFT+B) eller hot reload med InjectionIII
KMP (shared)	Alltid full build (CMD+SHIFT+B)

Debug

1. Bygg og kjor appen (CMD+SHIFT+B)
2. F5 eller Run & Debug -> "Attach to running app (SweetPad)"
3. Sett breakpoints i Swift-koden

Hot reload med InjectionIII (kun Swift)

Prosjektet er allerede konfigurert med nodvendige linker-flagg og DebugInjection.swift.

1. Installer InjectionIII fra Mac App Store
2. Bygg og kjor appen en gang (CMD+SHIFT+B)
3. Start InjectionIII.app -> File -> Open -> velg apps/mobile-kmp/iosApp
4. Rediger Swift-fil -> lagre (CMD+S) -> simulator oppdateres (~1s)

aside.note

Hot reload gjelder kun Swift. KMP/shared-endringer krever alltid full build.

Sweetpad-feilsoking

Hvis Sweetpad ikke finner prosjektet fra repo-roten:

1. CMD+SHIFT+P -> Sweetpad: Generate Build Server Config, eller
2. Opprett apps/mobile-kmp/.vscode/settings.json:

{
  "sweetpad.workspacePath": "iosApp/iosApp.xcodeproj",
  "sweetpad.build.scheme": "iosApp",
  "sweetpad.build.configuration": "Debug"
}

Cursor CLI

# Apne prosjektet i Cursor fra terminal
cursor .
cursor apps/mobile-kmp

# Verifiser Cursor Agent CLI
agent --version

For a installere shell-kommandoene: Cursor -> CMD+SHIFT+P -> “Install ‘cursor’ to shell”.

Stoppe tjenester

# Stopp Docker-containere
pnpm docker:stop

# Stopp Supabase
pnpm db:stop