Hva er Lumi?

Lumi er et verktøy for å kjøre personvernvennlige surveys i digitale tjenester. Du definerer spørsmålene i TypeScript, widgeten kjører i din app, og all data forblir på din infrastruktur.

Lumi er bygget for norske virksomheter som vil samle brukerinnsikt uten å sende data ut av egen kontroll — enten du kjører på NAIS, i Docker Compose, eller med Helm.

Hvorfor Lumi?

• Survey as code — definer spørsmål i TypeScript, rett i kodebasen din. Ingen ekstern tjeneste.
• BYOC (Bring Your Own Cloud) — kjør på egen infrastruktur. All data forblir hos deg.
• API-nøkkel-auth — embed widgeten med en pk_-nøkkel direkte fra nettleseren, uten token exchange.
• OIDC-innlogging — dashboard-tilgang via standard OIDC (Entra ID, Keycloak, o.l.).
• Organisasjonsmodell — opprett organisasjon, team og OIDC-gruppekoblinger for tilgangsstyring.
• Selvstående widget med --lumi-* CSS-variabler — widgeten leverer all CSS og følger WCAG. Tilpass utseendet med CSS custom properties.
• Dashboard — filtrer, segmenter og eksporter survey-data med teambasert tilgangsstyring.

Arkitektur

Lumi består av tre deler: en frontend-widget, et API som lagrer data, og et dashboard som visualiserer innsikt.

Det finnes to integrasjonsmønstre:

Enterprise (API-nøkkel)

Widgeten sender svar direkte til Lumi API med en pk_-nøkkel. Ingen token exchange nødvendig.

For NAIS-kunder (TokenX / AzureAD)

Din backend gjør token exchange og videresender til Lumi API.

Pakkeoversikt

Pakke	Beskrivelse	Tech Stack
lumi-survey	Selvstående React-widget	React, --lumi-* CSS custom properties
lumi-api	Backend & Analyse API	Kotlin, Ktor, Postgres
lumi-dashboard	Admin-dashboard	TanStack Start, React

Hvem er Lumi for?

Lumi er laget for norske virksomheter som vil samle brukerinnsikt i sine digitale tjenester — enten det er en sluttbrukerflate, et internt fagsystem, eller en arbeidsgiver-portal.

Enterprise/BYOC-kunder trenger:

• En web-app (React eller vanilla JS) der widgeten skal vises
• Lumi API kjørende på egen infrastruktur (Docker Compose eller Helm)
• En OIDC-provider for dashboard-innlogging (valgfritt — Lumi kan kjøres i local-modus)

NAIS-kunder trenger:

• En React-app som kjører på NAIS
• Mulighet til å gjøre token exchange (TokenX eller AzureAD) for å sende inn svar

Neste steg

Klar til å komme i gang? Gå videre til Installer widget for å sette opp pakken i prosjektet ditt.