Compare commits

...

44 commits

Author SHA1 Message Date
22fad9e1db Fjern shelters.json frå git-sporing
Fila vart lagt til .gitignore i 012da23 men var framleis spora.
Ho vert generert av `bun run fetch-shelters` og skal ikkje versjonerast.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 16:44:11 +01:00
029cfa45f9 Bump versjon til v1.8.0 (versionCode 12)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 16:39:16 +01:00
015bc0d926 Bytt djuplenkjer frå tilfluktsrom:// til HTTPS App Links
SMS-appar gjenkjenner ikkje eigendefinerte URI-skjema som klikkbare
lenkjer. Brukar no https://tilfluktsrom.naiv.no/shelter/{id} som
opnar appen direkte (Android App Links med autoVerify) eller fell
tilbake til PWA i nettlesaren.

Android: DEEP_LINK_DOMAIN i build.gradle.kts, HTTPS intent-filter,
oppdatert handleDeepLinkIntent og shareShelter med HTTPS-URL.

PWA: assetlinks.json for Android-verifisering, djuplenkjehandtering
i app.ts, base-sti endra frå './' til '/', config.ts for domene.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 16:37:13 +01:00
ae249d5d47 Dokumenter arkitektur for Android-app og PWA
Beskriver designprinsipp, datapipeline, plattformspesifikke
implementasjonsdetaljar, delte algoritmar (Haversine, UTM-konvertering),
fråkobla-først-strategi og sikkerheit/personvern.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 16:04:49 +01:00
7d40c9e9a8 Fiks PWA: sivilforsvarsinfo, knappetekst og kompassvisning
- Info-knappen (ℹ) åpner nå sivilforsvarsdialog med alle 5 steg,
  med «Om»-lenke i bunnen (som Android-appen)
- Laste-overleggets knapper («Lagre kart» / «Hopp over») får
  tekst fra i18n i stedet for å være tomme
- Kompassvisningen resizes canvas når den blir synlig, fikser
  0×0-canvas når den initialiseres mens containeren er skjult

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 15:51:42 +01:00
012da23628 Legg shelters.json til .gitignore
Filen genereres ved bygging fra Geonorge-data og skal ikke
spores i git.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 15:41:19 +01:00
85c3d6953c Gjør PWA-stier relative for fleksibel utrulling
Appen kan nå serveres både på / og under en understi som
/tilfluktsrom uten endringer.

- Sett base: './' i vite.config.ts
- Endre alle absolutte stier i index.html til relative
- Oppdater manifest.webmanifest med start_url: "." og scope: "."
- navigateFallback uten ledende skråstrek

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 15:35:39 +01:00
8e6dbb6b24 Dokumenter utgivelsesprosess med PWA-distribusjon
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>
2026-03-23 15:30:24 +01:00
4a95e0e23f Fjern unpkg CDN-avhengigheit og legg til slett-buffer-knapp
Leaflet vendora:
- Fjerna CDN <link> for Leaflet CSS (allereie bundla via npm-import)
- Kartmarkør-ikon brukar bundla bilete i staden for unpkg URL-ar
- CSP stramma: unpkg ikkje lenger naudsynt i style-src/img-src

Slett buffer:
- «Slett lagra data»-knapp i om-dialogen
- Slettar localStorage, IndexedDB og tenestararbeidar-bufferar
- Lokalisert til en/nb/nn

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 15:10:30 +01:00
97225d1e77 Bump versjon til v1.7.0 (versionCode 11)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 15:03:19 +01:00
a829742fe6 Dokumenter bruk av emulator og Maestro for skjermbilete
Legg til Screenshots-seksjon i CLAUDE.md med:
- Emulatoroppsett (AVD, headless start, fake GPS)
- Maestro v2.3.0 for repeterbare skjermbiletesekvensar
- Fastlane-mappestiar for alle tre språk
- Liste over gjeldande skjermbilete

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 15:00:44 +01:00
73937c163d Oppdater skjermbilete og README med nye funksjonar
Nye skjermbilete frå emulator (Bergen sentrum):
- Kartvisning, valt tilfluktsrom, kompass med nordindikator,
  sivilforsvarsinfo, og ny om-side med personvernerklæring

README oppdatert:
- Femte skjermbilete (om-side) lagt til
- Nordindikator og tilgjengelegheit nemnde i funksjonslista
- Datakjelde retta: DSB, distribuert via Geonorge
- Sikkerheitsavsnittet utfylt med CSP, 24t GPS-utløp, User-Agent
- Personvernavsnittet utvida

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 14:57:26 +01:00
b34408bc7b Rett datakjelde: tilfluktsromdata kjem frå DSB, ikkje Geonorge
Geonorge er distribusjonsplattforma, men dataeigar er DSB
(Direktoratet for samfunnstryggleik og beredskap). Oppdatert
om-side og personverntekst i alle tre språk (en/nb/nn) for
både Android og PWA.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 14:31:47 +01:00
c1ac68e746 Legg til om-side, personvernerklæring og sikkerheitsforbetring
Om-side (Android + PWA):
- Ny AboutDialog med personvernerklæring, datakjelder og opphavsrett
- Opphavsrett flytta frå sivilforsvardialogen til om-sida
- Tilgjengeleg via «Om denne appen»-lenke i sivilforsvarsdialogen (Android)
  og ny om-knapp i statuslinja (PWA)
- Lokalisert til en/nb/nn

Personvern og sikkerheit:
- Lagra GPS-posisjon utløper etter 24 timar (widget_prefs)
- Widget viser «Trykk for å oppdatere» når posisjon manglar eller er utløpt
- Eigendefinert User-Agent (Tilfluktsrom/1.6.1) i OkHttp
- Content Security Policy (CSP) meta-tag i PWA
- Tenararbeidar bufrar berre HTTP 200-svar (ikkje opake)
- Kartbuffer-metadata runda til ~11km presisjon i localStorage
- crossorigin="anonymous" på Leaflet CSS

i18n-opprydding:
- Unicode-escapes erstatta med UTF-8-teikn i nb.ts og nn.ts

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 14:27:45 +01:00
6ba35add2f Legg til TalkBack-støtte og nordindikator på kompasset
Tilgjengelegheit (Android + PWA):
- Semantiske landemerke (header, main, aside, role=dialog)
- aria-live-regionar for statusoppdateringar og lasteoverlegg
- Fokusindikatorar (:focus-visible) og prefers-reduced-motion
- Auka trykkmål til 48dp (infoknapp, oppdater, del, widget)
- contentDescription på kart, kompass og framdriftsindikator
- aria-current og role=listitem på tilfluktsromliste
- Fokusfangst og fokusgjenoppretting i lasteoverlegg
- Ikkje-farge-indikator (▶) for valt tilfluktsrom
- Dynamisk lang-attributt basert på oppdaga språk
- Lokaliserte aria-label (en/nb/nn)

Nordindikator:
- DirectionArrowView teiknar diskret «N»-markør på omkrinsen
- Roterer uavhengig av hovudpila for kompasskalibrering
- Berre på stor kompassvisning, ikkje minipila

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 14:02:32 +01:00
f9f8ac3d60 Dokumenter byggvariantar og distribusjon i CLAUDE.md
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-14 18:30:36 +01:00
f5c064ab92 Bump versjon til v1.6.1 (versionCode 10)
- Fjern dependency metadata frå APK-signeringsblokka (dependenciesInfo)
  for F-Droid-kompatibilitet

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-14 13:15:14 +01:00
8e684f868e Flytt versjon direkte inn i build.gradle.kts for F-Droid-kompatibilitet
fdroidserver parser build.gradle.kts med regex for å finne versionCode
og versionName. Den dynamiske Properties-lastingen fra version.properties
ga "Couldn't find any version information". Erstatt med literale verdier
som fdroidserver kan lese.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 21:16:05 +01:00
9a00f07362 Fiks F-Droid-metadata: fjern punktum i kort beskrivelse, legg til ikon
F-Droid krever at short_description.txt ikke slutter med punktum.
Erstatt to setninger med én sammenhengende frase med tankestrek.
Legg til 512x512 icon.png generert fra appens adaptive ikon-vektorer.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 20:48:22 +01:00
9925e7ec64 Bump versjon til v1.6.0 (versionCode 9)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 20:35:33 +01:00
6903fb7e70 Flytt signeringskonfigurasjon til gitignorert keystore.properties
Passord og keystoresti var hardkodet i build.gradle.kts og synlig i
det offentlige repoet. Flyttet til keystore.properties som er
gitignorert. Bygget hopper over signering om filen mangler, slik at
F-Droid kan bygge og signere med sin egen nøkkel.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 20:29:53 +01:00
ff4b3245f5 Legg til fdroid-byggvariant uten Google Play Services
Splitt LocationProvider, ShelterWidgetProvider og WidgetUpdateWorker i
to varianter: standard (med Play Services for bedre GPS) og fdroid
(kun AOSP LocationManager). Play Services-avhengigheten er nå begrenset
til standardImplementation.

Begge varianter bygger og har identisk funksjonalitet — fdroid-varianten
mangler bare FusedLocationProviderClient som en ekstra lokasjonskilde.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 20:25:47 +01:00
f1b405950e Forbedre estimater i STANDING_ON_SHOULDERS med kilder
Erstatt grove estimater med reelle bidragstall fra GitHub, OpenHub og
prosjektsider. Legg til kildelenker for ~20 prosjekter, Mermaid-diagram,
og seksjon med interessante detaljer (SQLite med ~4 utviklere, Leaflet
fra Ukraina). Legg til Forgejo/Gitea og GitHub som manglende lag.

Oppdatert totalestimat: ~119 000 mennesker.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 20:09:29 +01:00
4c801e86b1 Rett opp blandinga av nynorsk og bokmål i README
README-en hadde ein del nynorskformer (eit, dei, sjå, peikar, lagrast,
osv.) blanda inn i det som elles var bokmål. Retta til konsekvent
bokmål gjennom heile dokumentet.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 19:30:17 +01:00
95e08e30e6 Oppdater README med skjermbilete og bruksrettleiing
Legg til skjermbilete frå appen i toppen av README, ei «Slik fungerer
appen»-seksjon som forklarar kart, kompass og sivilforsvarsinfo, og
lenkjer til personvernerklæring og Standing on Shoulders-dokument.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 19:25:46 +01:00
567af09072 Bump versjon til v1.5.0 (versionCode 8)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 19:19:12 +01:00
73b583111a Legg til dokument om menneska bak applikasjonen
Estimerer at ~116 000 personar har bidrege til verktøya, biblioteka,
datakjeldene og infrastrukturen som gjer det mogleg å byggje denne appen.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 19:17:23 +01:00
093de8487b Legg til F-Droid-skjermbilete og Maestro-automatisering
Automatiserte skjermbilete for alle tre språk (en-US, nb-NO, nn-NO)
med Maestro-flyt. Fire bilete per språk: kartvisning, valt tilfluktsrom,
kompassvisning og sivilforsvarsinfo. GPS-posisjon er sett til Bergen
sentrum (Torgallmenningen).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 19:17:16 +01:00
15c6797fcd Vis ventestatus i botnark når GPS ikkje er tilgjengeleg
Når tilfluktsromdata er lasta men GPS-posisjon manglar, viser
botnaka no «Ventar på GPS…» i staden for å vera tom. Posisjonsfiks
erstattar ventestatusen automatisk når han kjem.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 19:17:07 +01:00
12b83993c4 Bump versjon til v1.4.1 (versionCode 7)
Tilgjenge-, brukarvenlegheit- og metadataforbetringar sidan v1.4.0.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 10:21:22 +01:00
e9432756b0 Førebu F-Droid-metadata med fastlane-struktur (#8)
Legg til fastlane/metadata/android/ med tittel, skildringar og
endringsloggar for en-US, nb-NO og nn-NO (versionCode 3–6).
Dokumenter Play Services-avhengigheit og anti-feature-vurdering.

Skjermbilete må framleis leggjast til i images/-mappene.

Closes #8

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 10:07:01 +01:00
3c1da8adec Legg til haptisk tilbakemelding på knappetrykk og listeval (#11)
Android: HapticFeedbackConstants.VIRTUAL_KEY på alle knappar og
listeelement. PWA: navigator.vibrate(10ms) på same interaksjonar.

Closes #11

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 10:01:58 +01:00
c35ccb91bf Mjuk opp tonen i sivilforsvarsdialog-tittelen
Endrar «når alarmen går» til «hvis/om alarmen går» for å unngå
å implisere at ein nødsituasjon faktisk skjer.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 09:57:58 +01:00
d4364379ab Legg til opphavsrettsmelding
Legg til copyright-notis i README og i sivilforsvarsdialogen i appen.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 09:54:06 +01:00
7ca06948f1 Gjer widget-tidsstempel tydelegare med «Oppdatert»-prefiks
Endrar widget-tidsstempel frå berre «14:32» til «Oppdatert 14:32»
slik at det er tydeleg at dette er siste oppdateringstidspunkt.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 09:53:43 +01:00
1a72314e30 Legg til tilgjengelegheitsetiketter i PWA
- Legg til role=img og aria-label på retningspil-canvas
- Oppdater aria-label dynamisk med avstand ved val av tilfluktsrom
- Legg til direction_arrow_description-streng i alle tre språk

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 09:53:17 +01:00
fa4c379176 Forbetr kontrast på statustekst for WCAG AA
Endrar status_text frå #B0BEC5 (~4.5:1) til #CFD8DC (~6.5:1) mot
#16213E-bakgrunnen, i både Android-appen og PWA-en.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 09:52:54 +01:00
a3728798b8 Legg til tilgjengelegheitsetiketter og skjermlesar-fiksar (Android)
- Legg til contentDescription på tilfluktsrom-listeelement for TalkBack
- Erstatt emoji-kompassåtvaring med tilgjengeleg tekstresurs
- Vis «Ventar på GPS…» i staden for «—» ved ukjend avstand
- Legg til content_desc_shelter_item og compass_accuracy_warning-strengar (en/nb/nn)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 09:52:39 +01:00
5fd76678d4 Legg til sentralisert datakildeoversikt (SOURCES.md)
Samlar all attribusjon og lisensinformasjon for eksterne datakjelder
(Geonorge, OpenStreetMap, DSB) i éi fil. Førebur for issue #9
(internasjonale datakjelder).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 09:41:48 +01:00
fca34f893b Legg til sivilforsvarsinformasjon med offisielle DSB-retningslinjer (v1.4.0)
Ny info-knapp (ℹ) i statuslinja opnar ein dialog med sivilforsvars-
instruksjonar: viktig melding-signal, flyalarm, søk dekning, lytt til
NRK P1 på DAB-radio, og faren over-signal. Alt innhald er verifisert
mot offisielle DSB-retningslinjer og fungerer utan nett. Støttar alle
tre språk (en, nb, nn).

Fixes #4

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 09:32:55 +01:00
e61f503c81 Fiks widget som ikkje viser data utan å opne appen først
Widgeten kunne ikkje hente posisjonsdata i bakgrunnen fordi Android
avgrenser GPS-tilgang for bakgrunnsprosessar (BroadcastReceiver) frå
og med Android 8+. Både FusedLocationProviderClient og LocationManager
returnerte null umiddelbart ved aktiv førespurnad frå bakgrunnen.

Løysinga er å lagre siste GPS-posisjon til SharedPreferences kvar gong
MainActivity får ei ny posisjonsfiks. Widgeten og WidgetUpdateWorker
les denne som siste utveg etter at system-API-ar har feila.

Endringane i detalj:

Widget (ShelterWidgetProvider):
- Brukar goAsync() + bakgrunnstråd for asynkron oppdatering
- Prøver FusedLocationProvider (Play Services), så LocationManager
  (AOSP), og til slutt SharedPreferences som fallback
- Ny metode requestUpdateWithLocation() for å sende posisjon via
  intent extras (unngår separate posisjonsbuffertar)
- Viser tidsstempel (HH:mm) for å sjå når widgeten sist vart oppdatert

WidgetUpdateWorker:
- Aktivt ber om ny posisjonsfiks (getCurrentLocation) i staden for
  berre å lese passiv buffer
- Sender oppnådd posisjon direkte til widgeten via broadcast
- Fallback til SharedPreferences viss aktiv førespurnad feilar
- Ny runOnce()-metode for eingongsoppdatering

MainActivity:
- Lagrar GPS-posisjon til SharedPreferences ved kvar oppdatering
  (saveLastLocation) så widgeten kan bruke den i bakgrunnen

Relatert: #3

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-08 23:08:32 +01:00
3c49dbdcde Legg til automatisk widgetoppdatering og de-Google-retningslinjer (v1.3.1)
Widget oppdaterer seg sjølv via WorkManager kvar 15. min i bakgrunnen,
og i sanntid når appen er open og mottek GPS-oppdateringar.
Oppdaterer CLAUDE.md med de-Google-kompatibilitetsprinsipp.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-08 22:34:33 +01:00
a813edc0c3 Legg til deling av tilfluktsrom og deep link-støtte (v1.3.0)
Del tilfluktsrom via SMS/meldingsapper med adresse, kapasitet,
koordinatar og geo:-URI. Støttar tilfluktsrom://shelter/{id}
deep link for direkte navigering til eit tilfluktsrom.

Closes #3

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-08 22:23:28 +01:00
57a9072b4c Legg til hybrid lokasjon, dataferskheit, widget og personvern (v1.2.0)
- Hybrid LocationProvider: prøver Play Services først, faller tilbake
  til LocationManager for degooglede einingar (F-Droid-kompatibel)
- Dataferskheitsindikator i statuslinja med tre nivå (fersk/veke/gammal)
- Heimeskjerm-widget som viser næraste tilfluktsrom med avstand
- Personvernerklæring (PRIVACY.md) på engelsk og norsk

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-08 19:10:57 +01:00
108 changed files with 4234 additions and 4689 deletions

1
.gitignore vendored
View file

@ -9,3 +9,4 @@
.cxx
local.properties
/app/build
keystore.properties

View file

@ -0,0 +1,72 @@
# Maestro flow: Capture F-Droid screenshots for nn-NO (Nynorsk)
#
# Nynorsk is not supported as a system locale on stock Android.
# This flow uses per-app locale (API 33+) which requires NOT clearing app state,
# since clearState wipes per-app locale settings.
#
# Run the main screenshots.yaml first (any locale) so that map tiles are cached.
# Then set the per-app locale and run this flow:
#
# adb shell "cmd locale set-app-locales no.naiv.tilfluktsrom --locales nn"
# maestro test .maestro/screenshots-nn.yaml
appId: no.naiv.tilfluktsrom
env:
OUTPUT_DIR: "fastlane/metadata/android"
---
# Mock GPS: Bergen centrum (Torgallmenningen)
- setLocation:
latitude: 60.3913
longitude: 5.3221
# Launch WITHOUT clearing state (preserves per-app locale and cached tiles)
- launchApp:
appId: no.naiv.tilfluktsrom
clearState: false
permissions:
android.permission.ACCESS_FINE_LOCATION: allow
android.permission.ACCESS_COARSE_LOCATION: allow
# Wait for shelter data to load
- extendedWaitUntil:
visible:
id: "statusText"
timeout: 15000
# Wait for shelter list to populate
- extendedWaitUntil:
visible:
id: "shelterList"
timeout: 15000
- waitForAnimationToEnd
# Screenshot 1: Map view
- takeScreenshot:
path: "${OUTPUT_DIR}/nn-NO/images/phoneScreenshots/1_map_view"
# Screenshot 2: Tap second shelter
- tapOn: "Håkonsgaten 5"
- waitForAnimationToEnd
- takeScreenshot:
path: "${OUTPUT_DIR}/nn-NO/images/phoneScreenshots/2_shelter_selected"
# Screenshot 3: Compass view
- tapOn:
id: "toggleViewFab"
- waitForAnimationToEnd
- takeScreenshot:
path: "${OUTPUT_DIR}/nn-NO/images/phoneScreenshots/3_compass_view"
# Screenshot 4: Civil defense dialog
- tapOn:
id: "toggleViewFab"
- waitForAnimationToEnd
- tapOn:
id: "infoButton"
- waitForAnimationToEnd
- takeScreenshot:
path: "${OUTPUT_DIR}/nn-NO/images/phoneScreenshots/4_civil_defense_info"

95
.maestro/screenshots.yaml Normal file
View file

@ -0,0 +1,95 @@
# Maestro flow: Capture F-Droid screenshots for Tilfluktsrom
#
# Usage (from project root):
# maestro test .maestro/screenshots.yaml
#
# With a specific locale:
# LOCALE=nb-NO maestro test .maestro/screenshots.yaml
#
# Prerequisites:
# - Android emulator (API 31+) or device running
# - App installed: ./gradlew installDebug
# - Internet connection (needed for map tile caching)
# - Install Maestro: curl -Ls https://get.maestro.mobile.dev | bash
#
# GPS is mocked to Bergen centrum (Torgallmenningen area),
# which has several shelters within walking distance.
appId: no.naiv.tilfluktsrom
env:
LOCALE: "en-US"
OUTPUT_DIR: "fastlane/metadata/android"
---
# Mock GPS: Bergen centrum (Torgallmenningen)
- setLocation:
latitude: 60.3913
longitude: 5.3221
# Grant location permission and launch with fresh state
- launchApp:
appId: no.naiv.tilfluktsrom
clearState: true
permissions:
android.permission.ACCESS_FINE_LOCATION: allow
android.permission.ACCESS_COARSE_LOCATION: allow
# Wait for shelter data to load from bundled asset.
- extendedWaitUntil:
visible:
id: "statusText"
timeout: 15000
# The app shows a map caching prompt on first GPS fix when no cache exists.
# Tap "Cache map" and wait for caching to complete (~15s).
# This prevents the overlay from re-appearing on subsequent GPS updates.
- extendedWaitUntil:
visible:
id: "loadingOkButton"
timeout: 15000
- tapOn:
id: "loadingOkButton"
# Wait for caching to finish (4 zoom levels x 9 grid points x 300ms ≈ 11s + network)
- extendedWaitUntil:
notVisible:
id: "loadingOverlay"
timeout: 30000
# Let the map settle and shelter list populate after caching
- waitForAnimationToEnd
- extendedWaitUntil:
visible:
id: "shelterList"
timeout: 10000
# Screenshot 1: Map view with shelter markers and bottom sheet
- takeScreenshot:
path: "${OUTPUT_DIR}/${LOCALE}/images/phoneScreenshots/1_map_view"
# Screenshot 2: Tap the second shelter (Håkonsgaten 5) to show a different selection.
# Shelter addresses are locale-independent, so this works in all languages.
- tapOn: "Håkonsgaten 5"
- waitForAnimationToEnd
- takeScreenshot:
path: "${OUTPUT_DIR}/${LOCALE}/images/phoneScreenshots/2_shelter_selected"
# Screenshot 3: Switch to compass view
- tapOn:
id: "toggleViewFab"
- waitForAnimationToEnd
- takeScreenshot:
path: "${OUTPUT_DIR}/${LOCALE}/images/phoneScreenshots/3_compass_view"
# Screenshot 4: Switch back to map, open civil defense info dialog
- tapOn:
id: "toggleViewFab"
- waitForAnimationToEnd
- tapOn:
id: "infoButton"
- waitForAnimationToEnd
- takeScreenshot:
path: "${OUTPUT_DIR}/${LOCALE}/images/phoneScreenshots/4_civil_defense_info"

86
.maestro/take-screenshots.sh Executable file
View file

@ -0,0 +1,86 @@
#!/usr/bin/env bash
# Generate F-Droid screenshots for all locales using Maestro.
#
# Prerequisites:
# 1. Install Maestro: curl -Ls https://get.maestro.mobile.dev | bash
# 2. Start an Android emulator (API 33+): emulator -avd <avd_name>
# 3. Build and install the app: ./gradlew installDebug
# 4. Run this script: .maestro/take-screenshots.sh
#
# Screenshots are saved directly into fastlane/metadata/android/<locale>/images/
#
# Locale handling:
# - en-US and nb-NO use system locale (settings put system system_locales)
# - nn-NO (Nynorsk) requires per-app locale since Android doesn't support
# Nynorsk as a system locale — it falls back to Bokmål
set -euo pipefail
cd "$(dirname "$0")/.."
FLOW=".maestro/screenshots.yaml"
FLOW_NN=".maestro/screenshots-nn.yaml"
restart_framework() {
adb shell stop 2>/dev/null
sleep 2
adb shell start 2>/dev/null
sleep 8
}
ensure_root() {
adb root 2>/dev/null || true
sleep 1
}
echo "=== Ensuring root access ==="
ensure_root
# --- en-US ---
echo "=== Capturing screenshots for en-US ==="
mkdir -p "fastlane/metadata/android/en-US/images/phoneScreenshots"
rm -f "fastlane/metadata/android/en-US/images/.gitkeep"
adb shell "settings put system system_locales en-US"
restart_framework
sed -i 's/LOCALE: ".*"/LOCALE: "en-US"/' "$FLOW"
maestro test "$FLOW"
echo "=== Done: en-US ==="
echo ""
# --- nb-NO ---
echo "=== Capturing screenshots for nb-NO ==="
mkdir -p "fastlane/metadata/android/nb-NO/images/phoneScreenshots"
rm -f "fastlane/metadata/android/nb-NO/images/.gitkeep"
adb shell "settings put system system_locales nb-NO"
restart_framework
sed -i 's/LOCALE: ".*"/LOCALE: "nb-NO"/' "$FLOW"
maestro test "$FLOW"
sed -i 's/LOCALE: "nb-NO"/LOCALE: "en-US"/' "$FLOW"
echo "=== Done: nb-NO ==="
echo ""
# --- nn-NO (Nynorsk) ---
# Android doesn't support nn as a system locale, so we use per-app locale.
# The main flow must have run first to cache map tiles (nn flow uses clearState: false).
echo "=== Capturing screenshots for nn-NO ==="
mkdir -p "fastlane/metadata/android/nn-NO/images/phoneScreenshots"
rm -f "fastlane/metadata/android/nn-NO/images/.gitkeep"
adb shell "am force-stop no.naiv.tilfluktsrom"
adb shell "cmd locale set-app-locales no.naiv.tilfluktsrom --locales nn"
sleep 2
maestro test "$FLOW_NN"
echo "=== Done: nn-NO ==="
echo ""
# Restore en-US
adb shell "settings put system system_locales en-US"
adb shell "cmd locale set-app-locales no.naiv.tilfluktsrom --locales en"
restart_framework
echo "All screenshots captured."
echo "Check: fastlane/metadata/android/*/images/phoneScreenshots/"

455
ARCHITECTURE.md Normal file
View file

@ -0,0 +1,455 @@
# Architecture
This document describes the architecture of Tilfluktsrom, a Norwegian emergency shelter finder available as an Android app and a Progressive Web App (PWA). Both platforms share the same design philosophy — offline-first, no hard external dependencies — but are implemented independently.
## Table of Contents
- [Design Principles](#design-principles)
- [Data Pipeline](#data-pipeline)
- [Android App](#android-app)
- [Package Structure](#package-structure)
- [Data Layer](#data-layer)
- [Location & Navigation](#location--navigation)
- [Compass System](#compass-system)
- [Map & Tile Caching](#map--tile-caching)
- [Build Variants](#build-variants)
- [Home Screen Widget](#home-screen-widget)
- [Deep Linking](#deep-linking)
- [Progressive Web App](#progressive-web-app)
- [Module Structure](#module-structure)
- [Build System](#build-system)
- [Data Layer (PWA)](#data-layer-pwa)
- [Location & Compass (PWA)](#location--compass-pwa)
- [Map & Offline Tiles (PWA)](#map--offline-tiles-pwa)
- [Service Worker](#service-worker)
- [UI Components](#ui-components)
- [Shared Algorithms](#shared-algorithms)
- [UTM33N → WGS84 Conversion](#utm33n--wgs84-conversion)
- [Haversine Distance & Bearing](#haversine-distance--bearing)
- [Offline Capability Summary](#offline-capability-summary)
- [Security & Privacy](#security--privacy)
- [Internationalization](#internationalization)
---
## Design Principles
### Offline-First
This is an emergency app. Core functionality — finding the nearest shelter, compass navigation, distance display — must work without internet after initial setup. Network is used only for initial data download, periodic refresh, and map tile caching.
### De-Google Compatibility (Android)
The Android app runs on devices without Google Play Services (LineageOS, GrapheneOS, /e/OS). Every Google-specific API has an AOSP fallback. Play Services improve accuracy and battery life when available, but are never required.
### Minimal Dependencies
Both platforms use few, well-chosen libraries. No heavy frameworks, no external CDNs at runtime. The PWA bundles everything locally; the Android app uses only OSMDroid, Room, OkHttp, and WorkManager.
### Data Sovereignty
Shelter data comes directly from Geonorge (the Norwegian mapping authority). No intermediate servers. The app fetches, converts, and caches the data locally.
---
## Data Pipeline
Both platforms consume the same upstream data source:
```
Geonorge ZIP (EPSG:25833 UTM33N)
↓ Download (~320KB)
↓ Extract GeoJSON from ZIP
↓ Parse features
↓ Convert UTM33N → WGS84 (Karney method)
↓ Validate (Norway bounding box, required fields)
↓ Store locally
```
**Source URL:** `https://nedlasting.geonorge.no/geonorge/Samfunnssikkerhet/TilfluktsromOffentlige/GeoJSON/Samfunnssikkerhet_0000_Norge_25833_TilfluktsromOffentlige_GeoJSON.zip`
**Fields per shelter:**
| Field | Description |
|------------|--------------------------------------|
| `lokalId` | Unique identifier (UUID) |
| `romnr` | Shelter room number |
| `plasser` | Capacity (number of people) |
| `adresse` | Street address |
| `latitude` | WGS84 latitude (converted from UTM) |
| `longitude`| WGS84 longitude (converted from UTM) |
**When conversion happens:**
- **Android:** At runtime during data download (`ShelterGeoJsonParser`)
- **PWA:** At build time (`scripts/fetch-shelters.ts`), output is pre-converted `shelters.json`
---
## Android App
**Language:** Kotlin · **Min SDK:** 26 (Android 8.0) · **Target SDK:** 35
**Build:** Gradle 8.7, AGP 8.5.2, KSP for Room annotation processing
### Package Structure
```
no.naiv.tilfluktsrom/
├── TilfluktsromApp.kt # Application class (OSMDroid config)
├── MainActivity.kt # Central UI controller (~870 lines)
├── data/
│ ├── Shelter.kt # Room entity
│ ├── ShelterDatabase.kt # Room database singleton
│ ├── ShelterDao.kt # Data access object (Flow queries)
│ ├── ShelterRepository.kt # Repository: bundled seed + network refresh
│ ├── ShelterGeoJsonParser.kt # GeoJSON ZIP → Shelter list
│ └── MapCacheManager.kt # Offline map tile pre-caching
├── location/
│ ├── LocationProvider.kt # GPS provider (flavor-specific)
│ └── ShelterFinder.kt # Nearest N shelters by Haversine
├── ui/
│ ├── DirectionArrowView.kt # Custom compass arrow View
│ ├── ShelterListAdapter.kt # RecyclerView adapter for shelter list
│ ├── CivilDefenseInfoDialog.kt # Emergency instructions
│ └── AboutDialog.kt # Privacy and copyright
├── util/
│ ├── CoordinateConverter.kt # UTM33N → WGS84 (Karney method)
│ └── DistanceUtils.kt # Haversine distance and bearing
└── widget/
├── ShelterWidgetProvider.kt # Home screen widget (flavor-specific)
└── WidgetUpdateWorker.kt # WorkManager periodic update
```
Files under `location/` and `widget/` have separate implementations per build variant:
- `app/src/standard/java/` — Google Play Services variant
- `app/src/fdroid/java/` — AOSP-only variant
### Data Layer
**Storage:** Room (SQLite) with a single `shelters` table.
**Loading strategy (three-layer fallback):**
1. **Bundled asset** (`assets/shelters.json`): Pre-converted WGS84 data, loaded on first launch via `ShelterRepository.seedFromAsset()`. Marked as stale (timestamp=0) so a network refresh is attempted when possible.
2. **Room database**: ~556 shelters cached locally. Reactive updates via Kotlin Flow. Atomic refresh: `deleteAll()` + `insertAll()` in a single transaction.
3. **Network refresh**: Downloads the Geonorge ZIP via OkHttp, parses with `ShelterGeoJsonParser`. Staleness threshold: 7 days. Runs in the background; failure does not block the UI.
**GeoJSON parsing pipeline:**
```
OkHttp response stream
→ ZipInputStream (find .geojson entry, 10MB size limit)
→ JSON parsing (features array)
→ Per feature:
→ Extract UTM33N coordinates
→ CoordinateConverter.utm33nToWgs84()
→ Validate: lokalId not blank, plasser ≥ 0, within Norway bounds
→ Create Shelter entity (skip malformed features with warning)
```
### Location & Navigation
**LocationProvider** abstracts GPS access with two flavor implementations:
| Flavor | Primary | Fallback |
|-----------|----------------------------------|-------------------|
| standard | FusedLocationProviderClient | LocationManager |
| fdroid | LocationManager | — |
Both emit location updates via Kotlin Flow. Update interval: 5 seconds, fastest 2 seconds.
**ShelterFinder** takes the user's position and all shelters, computes Haversine distance and initial bearing for each, sorts by distance, and returns the N nearest (default: 3) as `ShelterWithDistance` objects.
### Compass System
**Sensor priority:**
1. Rotation Vector sensor (`TYPE_ROTATION_VECTOR`) — most accurate, single sensor
2. Accelerometer + Magnetometer — low-pass filtered (α=0.25) for smoothing
3. No compass available — error message shown
**Direction calculation:**
```
arrowAngle = shelterBearing deviceHeading
```
**DirectionArrowView** is a custom View that draws:
- A large arrow rotated by `arrowAngle`, pointing toward the shelter
- An optional north indicator on the perimeter for compass calibration
### Map & Tile Caching
**Map library:** OSMDroid (OpenStreetMap, no Google dependency).
**Tile caching:** OSMDroid's built-in `SqlTileWriter` passively caches every tile loaded. `MapCacheManager` supplements this with active pre-caching:
- Pans the MapView across a 3×3 grid at zoom levels 10, 12, 14, 16
- 300ms delay between pans (respects OSM tile usage policy)
- Covers ~15km radius around the user
- Progress reported via callback for UI display
Tile cache stored in app-specific internal storage (`osmdroidBasePath`).
### Build Variants
```
productFlavors {
standard { } // Google Play Services + AOSP fallback
fdroid { } // AOSP only
}
```
The `standard` flavor adds `com.google.android.gms:play-services-location`. Runtime detection via `GoogleApiAvailability` determines which code path runs.
Both flavors produce identical user experiences — `standard` achieves faster GPS fixes and better battery efficiency when Play Services are present.
### Home Screen Widget
**ShelterWidgetProvider** displays the nearest shelter's address, capacity, and distance. Updated by:
1. **MainActivity** — sends latest location on each GPS update
2. **WorkManager**`WidgetUpdateWorker` runs every 15 minutes, requests a fresh location fix
3. **Manual** — user taps refresh button on the widget
**Location resolution (priority order):**
1. Location from intent (WorkManager or MainActivity)
2. FusedLocationProviderClient cache (standard)
3. Active GPS request (10s timeout)
4. LocationManager cache
5. SharedPreferences saved location (max 24h old)
### Deep Linking
**HTTPS App Links:** `https://tilfluktsrom.naiv.no/shelter/{lokalId}`
The domain is configured in one place: `DEEP_LINK_DOMAIN` in `build.gradle.kts` (exposed as `BuildConfig.DEEP_LINK_DOMAIN` and manifest placeholder `${deepLinkHost}`).
- `autoVerify="true"` on the HTTPS intent filter triggers Android's App Links verification at install time
- Verification requires `/.well-known/assetlinks.json` to be served by the PWA (in `pwa/public/.well-known/`)
- If the app is installed and verified, `/shelter/*` links open the app directly (no disambiguation dialog)
- If not installed, the link opens in the browser, where the PWA handles it
Share messages include the HTTPS URL, which SMS apps auto-link as a tappable URL.
---
## Progressive Web App
**Stack:** TypeScript, Vite 5, Leaflet, idb (IndexedDB wrapper), vite-plugin-pwa
**Package manager:** bun
### Module Structure
```
pwa/
├── index.html # SPA shell, CSP headers, semantic layout
├── vite.config.ts # Build config, PWA plugin, tile caching rules
├── manifest.webmanifest # PWA metadata and icons
├── scripts/
│ └── fetch-shelters.ts # Build-time: download + convert shelter data
├── public/
│ └── data/shelters.json # Pre-processed shelter data (build artifact)
└── src/
├── main.ts # Entry point, SW registration, locale init
├── app.ts # Main controller (~400 lines)
├── types.ts # Shelter, ShelterWithDistance, LatLon interfaces
├── data/
│ ├── shelter-repository.ts # Fetch + IndexedDB storage
│ └── shelter-db.ts # IndexedDB wrapper (idb library)
├── location/
│ ├── location-provider.ts # navigator.geolocation wrapper
│ ├── compass-provider.ts # DeviceOrientationEvent (iOS/Android)
│ └── shelter-finder.ts # Haversine nearest-N calculation
├── ui/
│ ├── map-view.ts # Leaflet map, custom SVG markers
│ ├── compass-view.ts # Canvas-based direction arrow
│ ├── shelter-list.ts # Bottom sheet shelter list
│ ├── loading-overlay.ts # Modal spinner / cache prompt
│ ├── about-dialog.ts # Privacy, data info, cache clear
│ ├── civil-defense-dialog.ts # DSB 5-step emergency guide
│ └── status-bar.ts # Status text and refresh button
├── cache/
│ └── map-cache-manager.ts # Tile pre-caching via programmatic panning
├── i18n/
│ ├── i18n.ts # Locale detection, string substitution
│ ├── en.ts # English strings
│ ├── nb.ts # Bokmål strings
│ └── nn.ts # Nynorsk strings
├── util/
│ └── distance-utils.ts # Haversine distance, bearing, formatting
└── main.css # Dark theme, Leaflet overrides, dialogs
```
### Build System
**Vite** bundles the app with content-hashed filenames for cache busting.
**Key configuration:**
- Base path: `./` (relative, deployable anywhere)
- `__BUILD_REVISION__` define: ISO timestamp injected at build time, used to invalidate service worker caches
- **vite-plugin-pwa**: Generates the service worker with Workbox. Precaches all static assets. Runtime-caches OSM tile requests with CacheFirst strategy (30-day expiry, max 5000 entries).
**Build-time data preprocessing:**
`scripts/fetch-shelters.ts` downloads the Geonorge ZIP, extracts the GeoJSON, converts UTM33N→WGS84, validates, and writes `public/data/shelters.json`. This means coordinate conversion is a build step, not a runtime cost.
```bash
bun run fetch-shelters # Download and convert shelter data
bun run build # TypeScript check + Vite build + SW generation
```
### Data Layer (PWA)
**Storage:** IndexedDB via the `idb` library.
**Schema:**
- Object store `shelters` (keyPath: `lokalId`) — full shelter records
- Object store `metadata``lastUpdate` timestamp
**Loading strategy:**
1. Check IndexedDB for cached shelters
2. If empty or stale (>7 days): fetch `shelters.json` (precached by service worker)
3. Replace all records in a single transaction
4. Reactive: UI reads from IndexedDB after load
Unlike the Android app, the PWA does not perform coordinate conversion at runtime — `shelters.json` is pre-converted at build time and served as a static asset.
### Location & Compass (PWA)
**Location:** `navigator.geolocation.watchPosition()` with high accuracy enabled, 10s maximum age, 30s timeout.
**Compass:** DeviceOrientationEvent with platform-specific handling:
| Platform | API | Heading Source |
|----------------|------------------------------|--------------------------|
| iOS Safari | `deviceorientation` | `webkitCompassHeading` |
| Android Chrome | `deviceorientationabsolute` | `(360 alpha) % 360` |
iOS 13+ requires an explicit permission request (`DeviceOrientationEvent.requestPermission()`), triggered by a user gesture.
Low-pass filter (smoothing factor 0.3) with 0/360° wraparound handling ensures fluid rotation.
### Map & Offline Tiles (PWA)
**Map library:** Leaflet with OpenStreetMap tiles. No CDN — Leaflet is bundled from `node_modules`.
**Custom markers:** SVG-based `divIcon` elements — orange house with "T" for shelters, blue circle for user location. Selected shelter uses a larger yellow marker.
**Auto-fit logic:** When a shelter is selected, the map fits bounds to show both user and shelter (30% padding), unless the user has manually panned or zoomed. A "reset view" button appears after manual interaction.
**Tile pre-caching:** `MapCacheManager` uses the same approach as the Android app — programmatically pans the map across a 3×3 grid at 4 zoom levels. The service worker's runtime cache intercepts and stores the tile requests. Cache location stored in localStorage (rounded to ~11km precision for privacy).
### Service Worker
Generated by vite-plugin-pwa (Workbox):
- **Precaching:** All static assets (JS, CSS, HTML, JSON, images) with content-hash versioning
- **Runtime caching:** OSM tiles from `{a,b,c}.tile.openstreetmap.org` with CacheFirst strategy, 30-day TTL, max 5000 entries
- **Navigation fallback:** Serves `index.html` for all navigation requests (SPA behavior)
- **Auto-update:** New service worker activates automatically; `controllerchange` event notifies the user
`main.ts` injects the build revision into the service worker context, ensuring each build invalidates stale caches. It also requests persistent storage (`navigator.storage.persist()`) to prevent the browser from evicting cached data.
### UI Components
The PWA uses no framework — all UI is vanilla TypeScript manipulating the DOM.
| Component | Description |
|--------------------------|----------------------------------------------------------|
| `app.ts` | Main controller: wires components, manages state |
| `map-view.ts` | Leaflet map with custom markers, auto-fit, interaction tracking |
| `compass-view.ts` | Canvas-rendered arrow with north indicator, requestAnimationFrame |
| `shelter-list.ts` | Bottom sheet with 3 nearest shelters, click selection |
| `loading-overlay.ts` | Modal: spinner during load, OK/Skip for cache prompt |
| `about-dialog.ts` | Privacy statement, data sources, "clear cache" button |
| `civil-defense-dialog.ts`| DSB emergency instructions (5 steps) |
| `status-bar.ts` | Data freshness indicator, refresh button |
Dialogs are created dynamically and implement focus management (save/restore previous focus, trap focus inside modal).
---
## Shared Algorithms
Both platforms implement these algorithms independently (no shared code), ensuring each platform has zero runtime dependencies on the other.
### UTM33N → WGS84 Conversion
**Algorithm:** Karney series expansion method.
Converts EUREF89 / UTM zone 33N (EPSG:25833) to WGS84 (EPSG:4326).
**Constants:**
- Semi-major axis: 6,378,137 m
- Flattening: 1/298.257223563
- UTM zone 33 central meridian: 15° E
- Scale factor: 0.9996
- False easting: 500,000 m
**Steps:**
1. Remove false easting/northing
2. Compute footprint latitude using series expansion
3. Apply iterative corrections for latitude and longitude
4. Add central meridian offset
**Validation:** Reject results outside Norway bounding box (5772°N, 333°E).
**Implementations:**
- Android: `util/CoordinateConverter.kt` (runtime)
- PWA: `scripts/fetch-shelters.ts` (build-time)
### Haversine Distance & Bearing
**Distance** between two WGS84 points:
```
a = sin²(Δφ/2) + cos(φ₁) · cos(φ₂) · sin²(Δλ/2)
d = 2R · atan2(√a, √(1a))
```
Where R = 6,371 km (Earth mean radius).
**Initial bearing** from point 1 to point 2:
```
θ = atan2(sin(Δλ) · cos(φ₂), cos(φ₁) · sin(φ₂) sin(φ₁) · cos(φ₂) · cos(Δλ))
```
Result in degrees: 0° = north, 90° = east, 180° = south, 270° = west.
**Implementations:**
- Android: `util/DistanceUtils.kt`
- PWA: `util/distance-utils.ts`
---
## Offline Capability Summary
| Capability | Android | PWA |
|-------------------------|----------------------------------|------------------------------------|
| Shelter data | Room DB + bundled asset seed | IndexedDB + precached JSON |
| Map tiles | OSMDroid SqlTileWriter + active pre-cache | Service worker CacheFirst + active pre-cache |
| GPS | Device hardware (no network) | Device hardware (no network) |
| Compass | Device sensors | DeviceOrientationEvent |
| Distance/bearing math | Local computation | Local computation |
| Network required for | Initial refresh, new tiles | Initial page load, new tiles |
| Staleness threshold | 7 days | 7 days |
---
## Security & Privacy
- **No tracking:** No analytics, no telemetry, no external requests beyond Geonorge data and OSM tiles
- **No user accounts:** No registration, no login, no server-side storage
- **Location stays local:** GPS coordinates are used only for distance calculation and never transmitted
- **HTTPS enforced:** Android network security config restricts to TLS; PWA CSP headers restrict connections
- **ZIP bomb protection:** 10MB limit on uncompressed GeoJSON (Android parser)
- **CSP headers (PWA):** Restrictive Content-Security-Policy blocks external scripts; `img-src` allows only OSM tile servers
- **Input validation:** Shelter data validated at parse time (bounds check, required fields, non-negative capacity)
- **Minimal permissions:** Location only; no contacts, camera, storage (except legacy tile cache on Android ≤9)
---
## Internationalization
Both platforms support three languages:
| Language | Android | PWA |
|---------------------|----------------------|----------------|
| English (default) | `values/strings.xml` | `i18n/en.ts` |
| Norwegian Bokmål | `values-nb/strings.xml` | `i18n/nb.ts` |
| Norwegian Nynorsk | `values-nn/strings.xml` | `i18n/nn.ts` |
**Android:** Uses Android's built-in locale resolution. Per-app language selection supported on Android 13+ via `locales_config.xml`.
**PWA:** Detects browser language (`navigator.language`). String substitution supports `%d` (number) and `%s` (string) placeholders. Falls back to English for unsupported locales.

View file

@ -3,13 +3,28 @@
## Project Overview
Android app (Kotlin) that helps find the nearest public shelter (tilfluktsrom) in Norway during emergencies. Offline-first design: must work without internet after initial data cache.
## Design Principles
### De-Google Compatibility
The app must work on devices without Google Play Services (e.g. LineageOS, GrapheneOS, /e/OS). Every feature that uses a Google-specific API must have a fallback that works without it. Use Google Play Services when available for better accuracy/performance, but never as a hard dependency.
**Pattern**: Check for Play Services at runtime, fall back to AOSP/standard APIs.
- **Location**: Prefer FusedLocationProviderClient (Play Services) → fall back to LocationManager (AOSP)
- **Maps**: OSMDroid (no Google dependency)
- **Database**: Room/SQLite (no Google dependency)
- **Background work**: WorkManager (works without Play Services via built-in scheduler)
### Offline-First
This is an emergency app. Assume internet and infrastructure may be degraded or unavailable. All core functionality (finding nearest shelter, compass navigation, sharing location) must work offline after initial data cache. Avoid solutions that depend on external servers being reachable.
## Architecture
- **Language**: Kotlin, targeting Android API 26+ (Android 8.0+)
- **Build**: Gradle 8.7, AGP 8.5.2, KSP for Room annotation processing
- **Maps**: OSMDroid (offline-capable OpenStreetMap)
- **Database**: Room (SQLite) for shelter data cache
- **HTTP**: OkHttp for data downloads
- **Location**: Google Play Services Fused Location Provider
- **Location**: FusedLocationProviderClient (Play Services) with LocationManager fallback
- **Background**: WorkManager for periodic widget updates
- **UI**: Traditional Views with ViewBinding
## Key Data Flow
@ -29,6 +44,7 @@ no.naiv.tilfluktsrom/
├── data/ # Room entities, DAO, repository, GeoJSON parser, map cache
├── location/ # GPS location provider, nearest shelter finder
├── ui/ # Custom views (DirectionArrowView), adapters
├── widget/ # Home screen widget, WorkManager periodic updater
└── util/ # Coordinate conversion (UTM→WGS84), distance calculations
```
@ -37,6 +53,62 @@ no.naiv.tilfluktsrom/
./gradlew assembleDebug
```
## Build Variants
- **standard**: Includes Google Play Services for better GPS accuracy
- **fdroid**: AOSP-only, no Google dependencies
## Distribution
- **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.
### Emulator setup
- AVD: `tilfluktsrom` (Pixel 6, API 35, google_apis/x86_64)
- Start headless: `~/android-sdk/emulator/emulator -avd tilfluktsrom -no-window -no-audio -no-boot-anim -gpu swiftshader_indirect &`
- When both a physical device and emulator are connected, use `-s emulator-5554` with adb
- Set fake GPS: `adb -s emulator-5554 emu geo fix <longitude> <latitude>` (note: longitude first)
- Grant permissions before launch: `adb -s emulator-5554 shell pm grant no.naiv.tilfluktsrom android.permission.ACCESS_FINE_LOCATION`
- Always cache map tiles ("Lagre kart") — never skip caching for screenshots
### Maestro (v2.3.0)
- Installed at `~/.maestro/bin/maestro`
- Use Maestro flows for repeatable screenshot sequences instead of manual `adb shell input tap` coordinates
- Maestro can target a specific device: `maestro --device emulator-5554 test flow.yaml`
- Place flows in a `maestro/` directory if creating reusable screenshot workflows
### Screenshot destinations
Screenshots go in all three fastlane locale directories:
- `fastlane/metadata/android/en-US/images/phoneScreenshots/`
- `fastlane/metadata/android/nb-NO/images/phoneScreenshots/`
- `fastlane/metadata/android/nn-NO/images/phoneScreenshots/`
Current screenshots:
1. `1_map_view.png` — Map with shelter markers
2. `2_shelter_selected.png` — Selected shelter with direction arrow
3. `3_compass_view.png` — Compass navigation with north indicator
4. `4_civil_defense_info.png` — Civil defense instructions
5. `5_about.png` — About page with privacy statement
## i18n
- Default (English): `res/values/strings.xml`
- Norwegian Bokmål: `res/values-nb/strings.xml`

44
F-DROID.md Normal file
View file

@ -0,0 +1,44 @@
# F-Droid submission notes
## Anti-features: Play Services dependency
The app includes `com.google.android.gms:play-services-location:21.3.0` for better location accuracy via `FusedLocationProviderClient`. However, this is **not a hard dependency**:
- The app checks for Play Services at runtime via `GoogleApiAvailability`
- If unavailable, it falls back to `LocationManager` (standard AOSP API)
- All core functionality (finding shelters, compass navigation, offline maps) works without Play Services
This was specifically designed to support degoogled devices (LineageOS, GrapheneOS, /e/OS).
### F-Droid build options
**Option A: Accept as-is with `NonFreeDep` anti-feature**
The app works fully without Play Services. Mark with `NonFreeDep` anti-feature.
**Option B: Build flavor without Play Services (recommended)**
Create a `fdroid` product flavor that excludes the Play Services dependency entirely. The fallback code paths already handle the absence — only the dependency and the Fused provider code need to be conditionally included.
## Metadata structure
```
fastlane/metadata/android/
├── en-US/ # English (default)
├── nb-NO/ # Norwegian Bokmål
└── nn-NO/ # Norwegian Nynorsk
```
Each locale contains `title.txt`, `short_description.txt`, `full_description.txt`, and `changelogs/` with per-versionCode files.
## Screenshots
Screenshots still need to be added to `images/` directories:
- `phoneScreenshots/` — at least 3 phone screenshots
- `featureGraphic.png` — 1024x500 feature graphic
## Build instructions
Standard Gradle build, no custom steps needed:
```
./gradlew assembleRelease
```

67
PRIVACY.md Normal file
View file

@ -0,0 +1,67 @@
# Privacy Policy / Personvernerklæring
**Tilfluktsrom — Norwegian Emergency Shelter Finder**
*Last updated: 2026-03-08*
---
## English
Tilfluktsrom is an open-source emergency shelter finder app. **We do not collect, store, or transmit any personal data.**
### What the app does with your data
- **Location**: Your GPS location is used **only on-device** to calculate the distance and direction to the nearest shelter. Your location is never sent to any server.
- **Shelter data**: Downloaded from [Geonorge](https://www.geonorge.no/) (a Norwegian government geographic data service). No user-identifying information is included in these requests.
- **Map tiles**: Fetched from OpenStreetMap via standard HTTP requests. No tracking or user identification is performed.
### What the app does NOT do
- No analytics or telemetry
- No advertising
- No cookies or local tracking
- No user accounts or registration
- No third-party SDKs that collect data
- No data sharing with any third party
### Permissions
- **Location**: Required to find the nearest shelter. Used only on-device.
- **Internet**: Required to download shelter data and map tiles. No personal data is transmitted.
- **Storage** (Android 89 only): Used for offline map tile cache.
### Contact
For questions about this privacy policy, open an issue at the project repository or contact the developer.
---
## Norsk
Tilfluktsrom er en åpen kildekode-app for å finne offentlige tilfluktsrom. **Vi samler ikke inn, lagrer eller overfører noen personopplysninger.**
### Hva appen gjør med dine data
- **Posisjon**: GPS-posisjonen din brukes **kun lokalt på enheten** for å beregne avstand og retning til nærmeste tilfluktsrom. Posisjonen din sendes aldri til noen server.
- **Tilfluktsromdata**: Lastes ned fra [Geonorge](https://www.geonorge.no/) (en norsk offentlig geografisk datatjeneste). Ingen brukeridentifiserende informasjon sendes.
- **Kartfliser**: Hentes fra OpenStreetMap via standard HTTP-forespørsler. Ingen sporing eller brukeridentifikasjon utføres.
### Hva appen IKKE gjør
- Ingen analyse eller telemetri
- Ingen reklame
- Ingen informasjonskapsler eller lokal sporing
- Ingen brukerkontoer eller registrering
- Ingen tredjeparts-SDK-er som samler data
- Ingen deling av data med tredjeparter
### Tillatelser
- **Posisjon**: Nødvendig for å finne nærmeste tilfluktsrom. Brukes kun lokalt på enheten.
- **Internett**: Nødvendig for å laste ned tilfluktsromdata og kartfliser. Ingen personopplysninger overføres.
- **Lagring** (kun Android 89): Brukes for frakoblet kartflislager.
### Kontakt
For spørsmål om denne personvernerklæringen, opprett en sak i prosjektets repository eller kontakt utvikleren.

View file

@ -2,13 +2,35 @@
Finn nærmeste offentlige tilfluktsrom i Norge. Appen er bygd for nødsituasjoner og fungerer uten internett etter første gangs bruk.
<p align="center">
<img src="fastlane/metadata/android/nb-NO/images/phoneScreenshots/1_map_view.png" width="180" alt="Kartvisning med tilfluktsrom i Bergen sentrum" />
<img src="fastlane/metadata/android/nb-NO/images/phoneScreenshots/2_shelter_selected.png" width="180" alt="Valgt tilfluktsrom med avstand og retningspil" />
<img src="fastlane/metadata/android/nb-NO/images/phoneScreenshots/3_compass_view.png" width="180" alt="Kompassnavigasjon med nordindikator" />
<img src="fastlane/metadata/android/nb-NO/images/phoneScreenshots/4_civil_defense_info.png" width="180" alt="Sivilforsvarsinfo: hva du skal gjøre om alarmen går" />
<img src="fastlane/metadata/android/nb-NO/images/phoneScreenshots/5_about.png" width="180" alt="Om-side med personvernerklæring" />
</p>
## Slik fungerer appen
**Kartvisning** — Appen viser alle 556 offentlige tilfluktsrom i Norge på et OpenStreetMap-kart. De tre nærmeste tilfluktsrommene vises i bunnen med avstand, kapasitet og romnummer. Trykk på en kartmarkering eller et listeelement for å velge et tilfluktsrom.
**Kompassnavigasjon** — Trykk på kompassknappen for å bytte til retningspil-visning. En stor pil peker mot det valgte tilfluktsrommet, med avstand i meter eller kilometer. En diskret nordindikator vises på kanten slik at du kan verifisere kompasskalibreringen. Fungerer uten internett — bare GPS og kompassensor.
**Sivilforsvarsinfo** — Trykk på info-knappen for å se trinn-for-trinn-veiledning fra DSB om hva du skal gjøre når alarmen går: viktig melding-signal, flyalarm, finn dekning, lytt til NRK på DAB-radio, og faren over.
**Om og personvern** — Appen samler ikke inn persondata. Alt skjer lokalt på enheten. Se om-siden i appen for fullstendig personvernerklæring, datakilder og opphavsrett.
## Funksjoner
- **Finn nærmeste tilfluktsrom** — viser de tre nærmeste tilfluktsrommene med avstand og kapasitet
- **Kompassnavigasjon** — retningspil som peker mot valgt tilfluktsrom
- **Finn nærmeste tilfluktsrom** — viser de tre nærmeste med avstand og kapasitet
- **Kompassnavigasjon** — retningspil som peker mot valgt tilfluktsrom, med nordindikator
- **Frakoblet kart** — kartfliser lagres automatisk for bruk uten nett
- **Velg fritt** — trykk på en hvilken som helst markør i kartet for å navigere dit
- **Velg fritt** — trykk på en markering i kartet for å navigere dit
- **Del tilfluktsrom** — send adresse, kapasitet og koordinater til andre
- **Sivilforsvarsinfo** — veiledning fra DSB om hva du skal gjøre når alarmen går
- **Hjemmeskjerm-widget** — viser nærmeste tilfluktsrom uten å åpne appen
- **Flerspråklig** — engelsk, bokmål og nynorsk
- **Tilgjengelighet** — TalkBack-støtte, fokusindikatorer og tilstrekkelig kontrast
## Plattformer
@ -34,7 +56,7 @@ Progressiv nettapp med Vite, TypeScript og Leaflet. Kan installeres på alle enh
## Datakilde
Tilfluktsromdata lastes ned fra [Geonorge](https://www.geonorge.no/) som GeoJSON i UTM33N-projeksjon (EPSG:25833). Koordinatene konverteres til WGS84 (bredde-/lengdegrad) for visning i kartet.
Tilfluktsromdata er offentlig informasjon fra [DSB](https://www.dsb.no/) (Direktoratet for samfunnssikkerhet og beredskap), distribuert via [Geonorge](https://www.geonorge.no/) som GeoJSON i UTM33N-projeksjon (EPSG:25833). Koordinatene konverteres til WGS84 (bredde-/lengdegrad) for visning i kartet.
Datasettet inneholder ca. 556 offentlige tilfluktsrom med adresse, romnummer og kapasitet (antall plasser).
@ -47,7 +69,8 @@ tilfluktsrom/
│ ├── java/.../
│ │ ├── data/ # Room-database, nedlasting, GeoJSON-parser
│ │ ├── location/ # GPS, nærmeste tilfluktsrom
│ │ ├── ui/ # Retningspil, liste-adapter
│ │ ├── ui/ # Retningspil, liste-adapter, om-dialog
│ │ ├── widget/ # Hjemmeskjerm-widget
│ │ └── util/ # UTM→WGS84-konvertering, avstandsberegning
│ └── res/ # Layout, strenger (en/nb/nn), ikoner
├── pwa/ # Nettapp (TypeScript)
@ -72,14 +95,27 @@ Appen er designet etter «offline-first»-prinsippet:
## Sikkerhet
- All nettverkstrafikk går over HTTPS
- All nettverkstrafikk går over HTTPS (klartekst er deaktivert)
- Content Security Policy (CSP) i PWA-versjonen
- Tilfluktsromdata valideres ved parsing (koordinater innenfor Norge, gyldige felt)
- Databaseoppdateringer er atomiske (transaksjon) for å unngå datatap
- Ingen persondata lagres — kun tilfluktsromdata og kartfliser
- Lagret GPS-posisjon utløper automatisk etter 24 timer
- Egendefinert User-Agent forhindrer enhetsfingeravtrykk
## Personvern
Appen samler ikke inn, sender eller deler noen personopplysninger. Det finnes ingen analyse, sporing eller tredjepartstjenester. GPS-posisjonen brukes bare lokalt på enheten for å finne nærmeste tilfluktsrom, og sendes aldri til noen server. Se om-siden i appen for fullstendig personvernerklæring.
## Opphavsrett
Copyright (c) Ole-Morten Duesund <olemd@glemt.net>
## Lisens
Kildekoden er lisensiert under [Mozilla Public License 2.0](LICENSE).
Tilfluktsromdata er åpne data fra Geonorge / Direktoratet for samfunnssikkerhet og beredskap (DSB).
Kartfliser fra OpenStreetMap er lisensiert under [ODbL](https://opendatacommons.org/licenses/odbl/).
Appen bruker åpne data og tjenester fra flere kilder. Se [SOURCES.md](SOURCES.md) for en fullstendig oversikt over datakilder, URL-er og lisenser.
## Se også
- [STANDING_ON_SHOULDERS.md](STANDING_ON_SHOULDERS.md) — estimat over de ~119 000 menneskene som har gjort denne appen mulig

17
SOURCES.md Normal file
View file

@ -0,0 +1,17 @@
# Data Sources
Centralized list of all external data sources used by the app. This is the authoritative reference for attribution, licensing, and usage context.
## Sources
| Source | Provider | URL | Usage | License | Used in |
|--------|----------|-----|-------|---------|---------|
| Shelter data (GeoJSON) | Geonorge / DSB | [nedlasting.geonorge.no/...](https://nedlasting.geonorge.no/geonorge/Samfunnssikkerhet/TilfluktsromOffentlige/GeoJSON/Samfunnssikkerhet_0000_Norge_25833_TilfluktsromOffentlige_GeoJSON.zip) | Shelter locations, capacity, addresses (~556 shelters) | [NLOD 2.0](https://data.norge.no/nlod/no/2.0) | `app/.../data/ShelterRepository.kt`, `pwa/scripts/fetch-shelters.ts` |
| Map tiles | OpenStreetMap | [tile.openstreetmap.org](https://tile.openstreetmap.org) | Offline-capable map display | [ODbL](https://opendatacommons.org/licenses/odbl/) | `app/` via OSMDroid, `pwa/src/ui/map-view.ts` via Leaflet |
| Civil defense guidelines | DSB (Direktoratet for samfunnssikkerhet og beredskap) | [dsb.no/sikkerhverdag/egenberedskap](https://www.dsb.no/sikkerhverdag/egenberedskap/) | Emergency instructions shown in the civil defense info dialog | Norwegian public sector information | `app/.../res/values/strings.xml` (civil_defense_* strings) |
## Notes
- **Shelter data** is downloaded as a ZIP containing GeoJSON in EPSG:25833 (UTM33N) projection. The app converts coordinates to WGS84 at parse time.
- **Map tiles** are cached locally by OSMDroid (Android) and the service worker (PWA) for offline use. OpenStreetMap's [tile usage policy](https://operations.osmfoundation.org/policies/tiles/) applies.
- **Civil defense guidelines** are adapted from official DSB recommendations, not quoted verbatim. Content is available in English, Bokmal, and Nynorsk.

192
STANDING_ON_SHOULDERS.md Normal file
View file

@ -0,0 +1,192 @@
# Standing on Shoulders
## How many people made this app possible?
Tilfluktsrom is a small Android app — about 900 source files — that helps
Norwegians find their nearest public shelter in an emergency. One person built
it in under a day. But that was only possible because of the accumulated work of
roughly **119,000 people**, spanning decades, countries, and disciplines.
This document traces the human effort behind every layer of the stack, with
sources for each estimate.
```mermaid
pie title People behind each layer
"Map data (OSM)" : 50000
"Linux kernel" : 20000
"Physical infrastructure" : 10500
"Build tools & dev infra" : 6700
"AI-assisted development" : 6000
"Shelter data & builders" : 6000
"Internet & standards" : 5250
"OS & runtimes (excl. Linux)" : 3800
"Libraries (Android)" : 2100
"Libraries (PWA)" : 1750
"Hosting & distribution" : 5700
"Programming languages" : 1600
```
---
## Layer 0: Physical Infrastructure — GPS & Sensors (~10,500 people)
| Component | Role | Est. people | Source |
|---|---|---|---|
| GPS constellation | 31 satellites, maintained by US Space Force | ~5,000 | Industry estimate; [GPS.gov](https://www.gps.gov/) |
| Magnetometer/compass sensors | Enable the direction arrow to point at shelters | ~500 | Industry estimate |
| ARM architecture | The CPU instruction set running every Android device | ~5,000 | [Arm had 8,330 employees in 2025](https://www.macrotrends.net/stocks/charts/ARM/arm-holdings/number-of-employees); ~5,000 estimated over the architecture's 40-year history |
Before a single line of code runs, hardware designed by tens of thousands of
engineers must be in orbit, in your pocket, and on the circuit board.
## Layer 1: Internet & Standards (~5,250 people)
| Component | Role | Est. people | Source |
|---|---|---|---|
| TCP/IP, DNS, HTTP, TLS | The protocols that carry shelter data from server to phone | ~5,000 | Cumulative IETF/W3C contributors over decades |
| GeoJSON specification | The format the shelter data is published in (IETF RFC 7946) | ~50 | [RFC 7946 authors + WG](https://datatracker.ietf.org/doc/html/rfc7946) |
| EPSG / coordinate reference systems | The math behind UTM33N → WGS84 coordinate conversion | ~200 | [IOGP Geomatics Committee](https://epsg.org/) |
## Layer 2: Operating Systems & Runtimes (~23,800 people)
| Component | Role | Est. people | Source |
|---|---|---|---|
| Linux kernel | Foundation of Android | ~20,000 | [Linux Foundation: ~20,000+ unique contributors since 2005](https://www.linuxfoundation.org/blog/blog/2017-linux-kernel-report-highlights-developers-roles-accelerating-pace-change) |
| Android (AOSP) | Mobile OS, incl. ART runtime | ~2,000 | [ResearchGate study: ~1,563 contributors](https://www.researchgate.net/figure/Top-Companies-Contributing-to-Android-Projects_tbl3_236631958); likely higher now |
| OpenJDK | The Java runtime Kotlin compiles to | ~1,800 | [GitHub: ~1,779 contributors](https://github.com/openjdk/jdk) |
## Layer 3: Programming Languages (~1,600 people)
| Language | Origin | Contributors | Source |
|---|---|---|---|
| Kotlin | JetBrains + community | ~765 | [GitHub: JetBrains/kotlin](https://github.com/JetBrains/kotlin) |
| TypeScript | Microsoft + community (for the PWA) | ~823 | [GitHub: microsoft/TypeScript](https://github.com/microsoft/TypeScript) |
## Layer 4: Build Tools & Dev Infrastructure (~6,700 people)
| Tool | Role | Contributors | Source |
|---|---|---|---|
| Gradle | Build automation | ~869 | [GitHub: gradle/gradle](https://github.com/gradle/gradle) |
| Android Gradle Plugin | Android-specific build pipeline | ~200 | Google internal; estimate |
| KSP (Kotlin Symbol Processing) | Code generation for Room database | ~100 | Estimate based on [GitHub: google/ksp](https://github.com/google/ksp) |
| R8 / ProGuard | Release minification and optimization | ~100 | Estimate |
| Vite | PWA bundler | ~1,100 | [GitHub: vitejs/vite](https://github.com/vitejs/vite) |
| Bun | Package manager and JS runtime | ~733 | [GitHub: oven-sh/bun](https://github.com/oven-sh/bun) |
| Git | Version control | ~1,820 | [GitHub: git/git](https://github.com/git/git) |
| Android Studio / IntelliJ | IDE | ~1,500 | Estimate; JetBrains + Google |
| Maven Central, Google Maven, npm | Package registry infrastructure | ~300 | Estimate |
## Layer 5: Libraries — Android App (~2,100 people)
| Library | What it does | Contributors | Source |
|---|---|---|---|
| AndroidX (Core, AppCompat, Room, WorkManager, etc.) | UI, architecture, database, scheduling | ~1,000 | [GitHub: androidx/androidx](https://github.com/androidx/androidx) monorepo |
| Material Design Components | Visual design language and components | ~199 | [GitHub: material-components-android](https://github.com/material-components/material-components-android) |
| Kotlinx Coroutines | Async data loading without blocking the UI | ~308 | [GitHub: Kotlin/kotlinx.coroutines](https://github.com/Kotlin/kotlinx.coroutines) |
| OkHttp | Downloads the GeoJSON ZIP from Geonorge | ~287 | [GitHub: square/okhttp](https://github.com/square/okhttp) |
| OSMDroid | Offline OpenStreetMap rendering | ~105 | [GitHub: osmdroid/osmdroid](https://github.com/osmdroid/osmdroid) |
| Play Services Location | FusedLocationProvider for precise GPS | ~200 | Google internal; estimate |
| SQLite | The embedded database engine | **~4** | [sqlite.org/crew.html](https://sqlite.org/crew.html) — the most deployed database in the world, maintained by 34 people |
## Layer 6: Libraries — PWA (~1,750 people)
| Library | Role | Contributors | Source |
|---|---|---|---|
| Leaflet | Interactive web maps (created in Ukraine) | ~865 | [GitHub: Leaflet/Leaflet](https://github.com/Leaflet/Leaflet) |
| leaflet.offline | Offline tile caching | ~20 | Estimate based on GitHub |
| idb | IndexedDB wrapper for offline storage | ~30 | Estimate based on GitHub |
| vite-plugin-pwa | Service worker and Workbox integration | ~100 | Estimate based on GitHub |
| Vitest | Test framework | ~718 | [GitHub: vitest-dev/vitest](https://github.com/vitest-dev/vitest) |
## Layer 7: Data — The Content That Makes It Useful (~56,000 people)
| Source | Role | Est. people | Source link |
|---|---|---|---|
| OpenStreetMap | Global map data | ~50,000 | [~2.25M have ever edited; ~50,000 active monthly](https://wiki.openstreetmap.org/wiki/Stats) |
| Kartverket / Geonorge | Norwegian Mapping Authority; national geodata infrastructure | ~800 | [kartverket.no](https://www.kartverket.no/) |
| DSB | Created and maintains the public shelter registry | ~200 | [dsb.no](https://www.dsb.no/) |
| The shelter builders | Construction, engineering, civil defense planning since the Cold War | ~5,000 | Estimate based on ~556 shelters built 1950s80s |
The app's data exists because of Cold War civil defense planning. The shelters
were built in the 1950s80s, digitized by DSB, published via Geonorge's open
data mandate — a chain of decisions spanning 70 years that now fits in a 320 KB
GeoJSON file.
## Layer 8: AI-Assisted Development (~6,000 people)
| Component | Role | Est. people | Source |
|---|---|---|---|
| Anthropic / Claude | Researchers, engineers, safety team | ~1,000 | [anthropic.com](https://www.anthropic.com/) |
| ML research lineage | Transformers, attention, RLHF, scaling laws — across academia & industry | ~5,000 | Estimate across all contributing institutions |
| Training data | The collective written output of humanity | incalculable | |
## Layer 9: Hosting & Distribution (~5,700 people)
| Component | Role | Contributors | Source |
|---|---|---|---|
| Forgejo / Gitea | Hosts this project at kode.naiv.no; Forgejo forked from Gitea in 2022 | ~800 | [Forgejo: ~230 contributors](https://codeberg.org/forgejo/forgejo); [Gitea: go-gitea/gitea](https://github.com/go-gitea/gitea) |
| GitHub | Mirror repo + hosts nearly all upstream dependencies | ~3,000 | [~5,000 employees, ~50% engineers](https://kinsta.com/blog/github-statistics/) |
| F-Droid | Open-source app store infrastructure and review | ~150 | [GitLab: fdroid](https://gitlab.com/fdroid); estimate |
| Fastlane | Metadata and screenshot tooling | ~1,524 | [GitHub: fastlane/fastlane](https://github.com/fastlane/fastlane) |
---
## Summary
| Layer | People |
|---|---|
| Physical infrastructure (GPS, ARM, sensors) | ~10,500 |
| Internet & standards | ~5,250 |
| Operating systems & runtimes | ~23,800 |
| Programming languages | ~1,600 |
| Build tools & dev infrastructure | ~6,700 |
| Direct libraries (Android) | ~2,100 |
| Direct libraries (PWA) | ~1,750 |
| Data (maps, shelters, geodesy) | ~56,000 |
| AI-assisted development | ~6,000 |
| Hosting & distribution | ~5,700 |
| **Conservative total** | **~119,000** |
This is conservative. It excludes:
- The millions of OSM mappers globally whose edits feed the tile rendering pipeline
- Hardware manufacturing (semiconductor fabs, device assembly — millions of workers)
- The educators who taught all these people their craft
- The civil defense planners who decided Norway needed public shelters
- The mathematicians behind Haversine, UTM projections, and geodesy going back centuries
Including OpenStreetMap's full contributor base and hardware, the number crosses
**2 million** easily.
---
## Notable details
- **SQLite** — the most widely deployed database engine in the world (in every
phone, browser, and operating system) — is maintained by
[34 people](https://sqlite.org/crew.html). It powers every shelter lookup
in this app.
- **Leaflet** — the JavaScript mapping library used by the PWA — was created by
[Volodymyr Agafonkin](https://agafonkin.com/) in Kyiv, Ukraine. An emergency
shelter app built with a mapping library from a country at war.
- **OpenStreetMap** has ~10 million registered accounts, but only ~50,000 are
active in any given month. The map tiles this app displays are the work of a
dedicated minority.
---
## Perspective
For every line of application code, roughly 119,000 people made the tools, data,
and infrastructure that line depends on. No single company, country, or
organization could have built this stack alone. Linux (Finland → global), Kotlin
(Czech Republic/Russia → JetBrains), OSM (UK → global), GPS (US military →
civilian), Leaflet (Ukraine), SQLite (US, public domain) — this emergency app is
a product of genuine global cooperation.
The fact that one person can build a working, offline-capable emergency app in
under a day is arguably one of the most remarkable expressions of accumulated
human cooperation — and almost none of it was coordinated by any central
authority.

View file

@ -6,11 +6,6 @@ plugins {
id("com.google.devtools.ksp")
}
// Read version from shared version.properties
val versionProps = Properties().apply {
rootProject.file("version.properties").inputStream().use { load(it) }
}
android {
namespace = "no.naiv.tilfluktsrom"
compileSdk = 35
@ -19,27 +14,45 @@ android {
applicationId = "no.naiv.tilfluktsrom"
minSdk = 26
targetSdk = 35
versionCode = versionProps.getProperty("versionCode").toInt()
versionName = "${versionProps.getProperty("versionMajor")}." +
"${versionProps.getProperty("versionMinor")}." +
versionProps.getProperty("versionPatch")
versionCode = 12
versionName = "1.8.0"
// Make version available in BuildConfig
buildConfigField("String", "VERSION_DISPLAY", "\"$versionName\"")
// Deep link domain — single source of truth for manifest + Kotlin code
val deepLinkDomain = "tilfluktsrom.naiv.no"
buildConfigField("String", "DEEP_LINK_DOMAIN", "\"$deepLinkDomain\"")
manifestPlaceholders["deepLinkHost"] = deepLinkDomain
}
dependenciesInfo {
includeInApk = false
includeInBundle = false
}
signingConfigs {
create("release") {
val keystorePath = System.getProperty("user.home") + "/.android/tilfluktsrom-release.jks"
if (file(keystorePath).exists()) {
storeFile = file(keystorePath)
storePassword = "tilfluktsrom"
keyAlias = "tilfluktsrom"
keyPassword = "tilfluktsrom"
val keystorePropsFile = rootProject.file("keystore.properties")
if (keystorePropsFile.exists()) {
val keystoreProps = Properties().apply {
keystorePropsFile.inputStream().use { load(it) }
}
storeFile = file(keystoreProps.getProperty("storeFile"))
storePassword = keystoreProps.getProperty("storePassword")
keyAlias = keystoreProps.getProperty("keyAlias")
keyPassword = keystoreProps.getProperty("keyPassword")
}
}
}
flavorDimensions += "distribution"
productFlavors {
create("standard") {
dimension = "distribution"
}
create("fdroid") {
dimension = "distribution"
}
}
buildTypes {
release {
isMinifyEnabled = true
@ -88,8 +101,11 @@ dependencies {
// OSMDroid (offline-capable OpenStreetMap)
implementation("org.osmdroid:osmdroid-android:6.1.20")
// Google Play Services Location (precise GPS)
implementation("com.google.android.gms:play-services-location:21.3.0")
// Google Play Services Location (precise GPS) — standard flavor only
"standardImplementation"("com.google.android.gms:play-services-location:21.3.0")
// WorkManager (periodic widget updates)
implementation("androidx.work:work-runtime-ktx:2.9.1")
// Coroutines
implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.8.1")

View file

@ -0,0 +1,119 @@
package no.naiv.tilfluktsrom.location
import android.Manifest
import android.content.Context
import android.content.pm.PackageManager
import android.location.Location
import android.location.LocationListener
import android.location.LocationManager
import android.os.Bundle
import android.os.Looper
import android.util.Log
import androidx.core.content.ContextCompat
import kotlinx.coroutines.channels.awaitClose
import kotlinx.coroutines.flow.Flow
import kotlinx.coroutines.flow.callbackFlow
/**
* Provides GPS location updates using AOSP LocationManager.
*
* F-Droid flavor: no Google Play Services dependency. Uses GPS + Network providers
* directly via LocationManager (available on all Android 8.0+ devices).
*/
class LocationProvider(private val context: Context) {
companion object {
private const val TAG = "LocationProvider"
private const val UPDATE_INTERVAL_MS = 5000L
}
init {
Log.d(TAG, "Location backend: LocationManager (F-Droid build)")
}
/**
* Stream of location updates. Emits the last known location first (if available),
* then continuous updates. Throws SecurityException if permission is not granted.
*/
fun locationUpdates(): Flow<Location> = callbackFlow {
if (!hasLocationPermission()) {
close(SecurityException("Location permission not granted"))
return@callbackFlow
}
val locationManager = context.getSystemService(Context.LOCATION_SERVICE)
as? LocationManager
if (locationManager == null) {
close(IllegalStateException("LocationManager not available"))
return@callbackFlow
}
// Emit best last known location immediately (pick most recent of GPS/Network)
try {
val lastGps = locationManager.getLastKnownLocation(LocationManager.GPS_PROVIDER)
val lastNetwork = locationManager.getLastKnownLocation(LocationManager.NETWORK_PROVIDER)
val best = listOfNotNull(lastGps, lastNetwork).maxByOrNull { it.time }
if (best != null) {
val result = trySend(best)
if (result.isFailure) {
Log.w(TAG, "Failed to emit last known location")
}
}
} catch (e: SecurityException) {
Log.e(TAG, "SecurityException getting last known location", e)
}
// LocationListener compatible with API 26-28 (onStatusChanged required before API 29)
val listener = object : LocationListener {
override fun onLocationChanged(location: Location) {
val sendResult = trySend(location)
if (sendResult.isFailure) {
Log.w(TAG, "Failed to emit location update")
}
}
// Required for API 26-28 compatibility (deprecated from API 29+)
@Deprecated("Deprecated in API 29")
override fun onStatusChanged(provider: String?, status: Int, extras: Bundle?) {}
override fun onProviderEnabled(provider: String) {}
override fun onProviderDisabled(provider: String) {}
}
try {
// Request from both providers: GPS is accurate, Network gives faster first fix
if (locationManager.isProviderEnabled(LocationManager.GPS_PROVIDER)) {
locationManager.requestLocationUpdates(
LocationManager.GPS_PROVIDER,
UPDATE_INTERVAL_MS,
0f,
listener,
Looper.getMainLooper()
)
}
if (locationManager.isProviderEnabled(LocationManager.NETWORK_PROVIDER)) {
locationManager.requestLocationUpdates(
LocationManager.NETWORK_PROVIDER,
UPDATE_INTERVAL_MS,
0f,
listener,
Looper.getMainLooper()
)
}
} catch (e: SecurityException) {
Log.e(TAG, "SecurityException requesting location updates", e)
close(e)
return@callbackFlow
}
awaitClose {
locationManager.removeUpdates(listener)
}
}
fun hasLocationPermission(): Boolean {
return ContextCompat.checkSelfPermission(
context, Manifest.permission.ACCESS_FINE_LOCATION
) == PackageManager.PERMISSION_GRANTED
}
}

View file

@ -0,0 +1,268 @@
package no.naiv.tilfluktsrom.widget
import android.Manifest
import android.app.PendingIntent
import android.appwidget.AppWidgetManager
import android.appwidget.AppWidgetProvider
import android.content.ComponentName
import android.content.Context
import android.content.Intent
import android.content.pm.PackageManager
import android.location.Location
import android.location.LocationManager
import android.os.Build
import android.os.CancellationSignal
import android.text.format.DateFormat
import android.util.Log
import android.widget.RemoteViews
import androidx.core.content.ContextCompat
import no.naiv.tilfluktsrom.MainActivity
import no.naiv.tilfluktsrom.R
import no.naiv.tilfluktsrom.data.ShelterDatabase
import no.naiv.tilfluktsrom.location.ShelterFinder
import no.naiv.tilfluktsrom.util.DistanceUtils
import java.util.concurrent.TimeUnit
/**
* Home screen widget showing the nearest shelter with distance.
*
* F-Droid flavor: uses LocationManager only (no Google Play Services).
*/
class ShelterWidgetProvider : AppWidgetProvider() {
companion object {
private const val TAG = "ShelterWidget"
const val ACTION_REFRESH = "no.naiv.tilfluktsrom.widget.REFRESH"
private const val EXTRA_LATITUDE = "lat"
private const val EXTRA_LONGITUDE = "lon"
fun requestUpdate(context: Context) {
val intent = Intent(context, ShelterWidgetProvider::class.java).apply {
action = ACTION_REFRESH
}
context.sendBroadcast(intent)
}
fun requestUpdateWithLocation(context: Context, latitude: Double, longitude: Double) {
val intent = Intent(context, ShelterWidgetProvider::class.java).apply {
action = ACTION_REFRESH
putExtra(EXTRA_LATITUDE, latitude)
putExtra(EXTRA_LONGITUDE, longitude)
}
context.sendBroadcast(intent)
}
}
override fun onEnabled(context: Context) {
super.onEnabled(context)
WidgetUpdateWorker.schedule(context)
}
override fun onDisabled(context: Context) {
super.onDisabled(context)
WidgetUpdateWorker.cancel(context)
}
override fun onUpdate(
context: Context,
appWidgetManager: AppWidgetManager,
appWidgetIds: IntArray
) {
WidgetUpdateWorker.schedule(context)
updateAllWidgetsAsync(context, null)
}
override fun onReceive(context: Context, intent: Intent) {
super.onReceive(context, intent)
if (intent.action == ACTION_REFRESH) {
val providedLocation = if (intent.hasExtra(EXTRA_LATITUDE)) {
Location("widget").apply {
latitude = intent.getDoubleExtra(EXTRA_LATITUDE, 0.0)
longitude = intent.getDoubleExtra(EXTRA_LONGITUDE, 0.0)
}
} else null
updateAllWidgetsAsync(context, providedLocation)
}
}
private fun updateAllWidgetsAsync(context: Context, providedLocation: Location?) {
val pendingResult = goAsync()
Thread {
try {
val appWidgetManager = AppWidgetManager.getInstance(context)
val widgetIds = appWidgetManager.getAppWidgetIds(
ComponentName(context, ShelterWidgetProvider::class.java)
)
val location = providedLocation ?: getBestLocation(context)
for (appWidgetId in widgetIds) {
updateWidget(context, appWidgetManager, appWidgetId, location)
}
} catch (e: Exception) {
Log.e(TAG, "Failed to update widgets", e)
} finally {
pendingResult.finish()
}
}.start()
}
private fun updateWidget(
context: Context,
appWidgetManager: AppWidgetManager,
appWidgetId: Int,
location: Location?
) {
val views = RemoteViews(context.packageName, R.layout.widget_nearest_shelter)
val openAppIntent = Intent(context, MainActivity::class.java)
val openAppPending = PendingIntent.getActivity(
context, 0, openAppIntent, PendingIntent.FLAG_IMMUTABLE
)
views.setOnClickPendingIntent(R.id.widgetRoot, openAppPending)
val refreshIntent = Intent(context, ShelterWidgetProvider::class.java).apply {
action = ACTION_REFRESH
}
val refreshPending = PendingIntent.getBroadcast(
context, 0, refreshIntent, PendingIntent.FLAG_IMMUTABLE
)
views.setOnClickPendingIntent(R.id.widgetRefreshButton, refreshPending)
if (ContextCompat.checkSelfPermission(
context, Manifest.permission.ACCESS_FINE_LOCATION
) != PackageManager.PERMISSION_GRANTED
) {
showFallback(context, views, context.getString(R.string.widget_open_app))
appWidgetManager.updateAppWidget(appWidgetId, views)
return
}
if (location == null) {
showFallback(context, views, context.getString(R.string.widget_no_location))
appWidgetManager.updateAppWidget(appWidgetId, views)
return
}
val shelters = try {
val dao = ShelterDatabase.getInstance(context).shelterDao()
kotlinx.coroutines.runBlocking { dao.getAllSheltersList() }
} catch (e: Exception) {
Log.e(TAG, "Failed to query shelters", e)
emptyList()
}
if (shelters.isEmpty()) {
showFallback(context, views, context.getString(R.string.widget_no_data))
appWidgetManager.updateAppWidget(appWidgetId, views)
return
}
val nearest = ShelterFinder.findNearest(
shelters, location.latitude, location.longitude, 1
).firstOrNull()
if (nearest == null) {
showFallback(context, views, context.getString(R.string.widget_no_data))
appWidgetManager.updateAppWidget(appWidgetId, views)
return
}
views.setTextViewText(R.id.widgetAddress, nearest.shelter.adresse)
views.setTextViewText(
R.id.widgetDetails,
context.getString(R.string.shelter_capacity, nearest.shelter.plasser)
)
views.setTextViewText(
R.id.widgetDistance,
DistanceUtils.formatDistance(nearest.distanceMeters)
)
views.setTextViewText(R.id.widgetTimestamp, formatTimestamp(context))
appWidgetManager.updateAppWidget(appWidgetId, views)
}
private fun showFallback(context: Context, views: RemoteViews, message: String) {
views.setTextViewText(R.id.widgetAddress, message)
views.setTextViewText(R.id.widgetDetails, "")
views.setTextViewText(R.id.widgetDistance, "")
views.setTextViewText(R.id.widgetTimestamp, formatTimestamp(context))
}
private fun formatTimestamp(context: Context): String {
val format = DateFormat.getTimeFormat(context)
val timeStr = format.format(System.currentTimeMillis())
return context.getString(R.string.widget_updated_at, timeStr)
}
/**
* Get the best available location via LocationManager or SharedPreferences.
* Safe to call from a background thread.
*/
private fun getBestLocation(context: Context): Location? {
if (ContextCompat.checkSelfPermission(
context, Manifest.permission.ACCESS_FINE_LOCATION
) != PackageManager.PERMISSION_GRANTED
) return null
val lmLocation = getLocationManagerLocation(context)
if (lmLocation != null) return lmLocation
return getSavedLocation(context)
}
/** Returns null if older than 24 hours to avoid retaining stale location data. */
private fun getSavedLocation(context: Context): Location? {
val prefs = context.getSharedPreferences("widget_prefs", Context.MODE_PRIVATE)
if (!prefs.contains("last_lat")) return null
val age = System.currentTimeMillis() - prefs.getLong("last_time", 0L)
if (age > 24 * 60 * 60 * 1000L) return null
return Location("saved").apply {
latitude = prefs.getFloat("last_lat", 0f).toDouble()
longitude = prefs.getFloat("last_lon", 0f).toDouble()
}
}
private fun getLocationManagerLocation(context: Context): Location? {
val locationManager = context.getSystemService(Context.LOCATION_SERVICE)
as? LocationManager ?: return null
try {
val lastGps = locationManager.getLastKnownLocation(LocationManager.GPS_PROVIDER)
val lastNetwork = locationManager.getLastKnownLocation(LocationManager.NETWORK_PROVIDER)
val cached = listOfNotNull(lastGps, lastNetwork).maxByOrNull { it.time }
if (cached != null) return cached
} catch (e: SecurityException) {
Log.e(TAG, "SecurityException getting last known location", e)
return null
}
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
val provider = when {
locationManager.isProviderEnabled(LocationManager.NETWORK_PROVIDER) ->
LocationManager.NETWORK_PROVIDER
locationManager.isProviderEnabled(LocationManager.GPS_PROVIDER) ->
LocationManager.GPS_PROVIDER
else -> return null
}
try {
val latch = java.util.concurrent.CountDownLatch(1)
var result: Location? = null
val signal = CancellationSignal()
locationManager.getCurrentLocation(
provider, signal, context.mainExecutor
) { location ->
result = location
latch.countDown()
}
latch.await(10, TimeUnit.SECONDS)
signal.cancel()
return result
} catch (e: Exception) {
Log.e(TAG, "Active location request failed", e)
}
}
return null
}
}

View file

@ -0,0 +1,136 @@
package no.naiv.tilfluktsrom.widget
import android.Manifest
import android.content.Context
import android.content.pm.PackageManager
import android.location.Location
import android.location.LocationManager
import android.os.Build
import android.os.CancellationSignal
import android.util.Log
import androidx.core.content.ContextCompat
import androidx.work.CoroutineWorker
import androidx.work.ExistingPeriodicWorkPolicy
import androidx.work.OneTimeWorkRequestBuilder
import androidx.work.PeriodicWorkRequestBuilder
import androidx.work.WorkManager
import androidx.work.WorkerParameters
import kotlinx.coroutines.suspendCancellableCoroutine
import kotlinx.coroutines.withTimeoutOrNull
import java.util.concurrent.TimeUnit
import kotlin.coroutines.resume
/**
* Periodic background worker that refreshes the home screen widget.
*
* F-Droid flavor: uses LocationManager only (no Google Play Services).
*/
class WidgetUpdateWorker(
context: Context,
params: WorkerParameters
) : CoroutineWorker(context, params) {
companion object {
private const val TAG = "WidgetUpdateWorker"
private const val WORK_NAME = "widget_update"
private const val LOCATION_TIMEOUT_MS = 10_000L
fun schedule(context: Context) {
val request = PeriodicWorkRequestBuilder<WidgetUpdateWorker>(
15, TimeUnit.MINUTES
).build()
WorkManager.getInstance(context).enqueueUniquePeriodicWork(
WORK_NAME,
ExistingPeriodicWorkPolicy.KEEP,
request
)
}
fun runOnce(context: Context) {
val request = OneTimeWorkRequestBuilder<WidgetUpdateWorker>().build()
WorkManager.getInstance(context).enqueue(request)
}
fun cancel(context: Context) {
WorkManager.getInstance(context).cancelUniqueWork(WORK_NAME)
}
}
override suspend fun doWork(): Result {
val location = requestFreshLocation() ?: getSavedLocation()
if (location != null) {
ShelterWidgetProvider.requestUpdateWithLocation(
applicationContext, location.latitude, location.longitude
)
} else {
ShelterWidgetProvider.requestUpdate(applicationContext)
}
return Result.success()
}
/** Returns null if older than 24 hours. */
private fun getSavedLocation(): Location? {
val prefs = applicationContext.getSharedPreferences("widget_prefs", Context.MODE_PRIVATE)
if (!prefs.contains("last_lat")) return null
val age = System.currentTimeMillis() - prefs.getLong("last_time", 0L)
if (age > 24 * 60 * 60 * 1000L) return null
return Location("saved").apply {
latitude = prefs.getFloat("last_lat", 0f).toDouble()
longitude = prefs.getFloat("last_lon", 0f).toDouble()
}
}
private suspend fun requestFreshLocation(): Location? {
val context = applicationContext
if (ContextCompat.checkSelfPermission(context, Manifest.permission.ACCESS_FINE_LOCATION)
!= PackageManager.PERMISSION_GRANTED
) return null
return requestViaLocationManager()
}
private suspend fun requestViaLocationManager(): Location? {
val locationManager = applicationContext.getSystemService(Context.LOCATION_SERVICE)
as? LocationManager ?: return null
val provider = when {
locationManager.isProviderEnabled(LocationManager.GPS_PROVIDER) ->
LocationManager.GPS_PROVIDER
locationManager.isProviderEnabled(LocationManager.NETWORK_PROVIDER) ->
LocationManager.NETWORK_PROVIDER
else -> return null
}
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
return requestCurrentLocation(locationManager, provider)
}
// API 26-29: fall back to passive cache
return try {
locationManager.getLastKnownLocation(provider)
} catch (e: SecurityException) {
null
}
}
private suspend fun requestCurrentLocation(locationManager: LocationManager, provider: String): Location? {
return try {
withTimeoutOrNull(LOCATION_TIMEOUT_MS) {
suspendCancellableCoroutine<Location?> { cont ->
val signal = CancellationSignal()
locationManager.getCurrentLocation(
provider,
signal,
applicationContext.mainExecutor
) { location ->
if (cont.isActive) cont.resume(location)
}
cont.invokeOnCancellation { signal.cancel() }
}
}
} catch (e: SecurityException) {
Log.e(TAG, "SecurityException requesting location via LocationManager", e)
null
}
}
}

View file

@ -23,11 +23,34 @@
<activity
android:name=".MainActivity"
android:exported="true"
android:launchMode="singleTop"
android:windowSoftInputMode="adjustPan">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
<intent-filter android:autoVerify="true">
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data
android:scheme="https"
android:host="${deepLinkHost}"
android:pathPrefix="/shelter/" />
</intent-filter>
</activity>
<receiver
android:name=".widget.ShelterWidgetProvider"
android:exported="true"
android:label="@string/nearest_shelter">
<intent-filter>
<action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
<action android:name="no.naiv.tilfluktsrom.widget.REFRESH" />
</intent-filter>
<meta-data
android:name="android.appwidget.provider"
android:resource="@xml/widget_info" />
</receiver>
</application>
</manifest>

View file

@ -3,6 +3,7 @@ package no.naiv.tilfluktsrom
import android.Manifest
import android.content.Context
import android.content.Intent
import android.view.HapticFeedbackConstants
import android.content.pm.PackageManager
import android.hardware.Sensor
import android.hardware.SensorEvent
@ -17,6 +18,7 @@ import android.provider.Settings
import android.util.Log
import android.view.View
import android.widget.Toast
import java.util.concurrent.TimeUnit
import androidx.activity.result.contract.ActivityResultContracts
import androidx.appcompat.app.AlertDialog
import androidx.appcompat.app.AppCompatActivity
@ -36,8 +38,10 @@ import no.naiv.tilfluktsrom.databinding.ActivityMainBinding
import no.naiv.tilfluktsrom.location.LocationProvider
import no.naiv.tilfluktsrom.location.ShelterFinder
import no.naiv.tilfluktsrom.location.ShelterWithDistance
import no.naiv.tilfluktsrom.ui.CivilDefenseInfoDialog
import no.naiv.tilfluktsrom.ui.ShelterListAdapter
import no.naiv.tilfluktsrom.util.DistanceUtils
import no.naiv.tilfluktsrom.widget.ShelterWidgetProvider
import org.osmdroid.util.GeoPoint
import org.osmdroid.views.CustomZoomButtonsController
import org.osmdroid.views.overlay.Marker
@ -73,6 +77,9 @@ class MainActivity : AppCompatActivity(), SensorEventListener {
// Whether a compass sensor is available on this device
private var hasCompassSensor = false
// Deep link: shelter ID to select once data is loaded
private var pendingDeepLinkShelterId: String? = null
// The currently selected shelter — can be any shelter, not just one from nearestShelters
private var selectedShelter: ShelterWithDistance? = null
// When true, location updates won't auto-select the nearest shelter
@ -126,6 +133,35 @@ class MainActivity : AppCompatActivity(), SensorEventListener {
setupShelterList()
setupButtons()
loadData()
handleDeepLinkIntent(intent)
}
override fun onNewIntent(intent: Intent) {
super.onNewIntent(intent)
setIntent(intent)
handleDeepLinkIntent(intent)
}
/**
* Handle https://{domain}/shelter/{lokalId} deep link.
* If shelters are already loaded, select immediately; otherwise store as pending.
*/
private fun handleDeepLinkIntent(intent: Intent?) {
val uri = intent?.data ?: return
if (uri.scheme != "https" ||
uri.host != BuildConfig.DEEP_LINK_DOMAIN ||
uri.path?.startsWith("/shelter/") != true) return
val lokalId = uri.lastPathSegment ?: return
// Clear intent data so config changes don't re-trigger
intent.data = null
val shelter = allShelters.find { it.lokalId == lokalId }
if (shelter != null) {
selectShelterByData(shelter)
} else {
pendingDeepLinkShelterId = lokalId
}
}
private fun setupMap() {
@ -169,6 +205,7 @@ class MainActivity : AppCompatActivity(), SensorEventListener {
private fun setupButtons() {
binding.toggleViewFab.setOnClickListener {
it.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY)
isCompassMode = !isCompassMode
if (isCompassMode) {
binding.mapView.visibility = View.GONE
@ -183,16 +220,29 @@ class MainActivity : AppCompatActivity(), SensorEventListener {
// Reset to navigation: re-fit map to show user + selected shelter
binding.resetNavigationFab.setOnClickListener {
it.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY)
userHasInteractedWithMap = false
binding.resetNavigationFab.visibility = View.GONE
selectedShelter?.let { highlightShelterOnMap(it) }
}
binding.infoButton.setOnClickListener {
it.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY)
CivilDefenseInfoDialog().show(supportFragmentManager, CivilDefenseInfoDialog.TAG)
}
binding.refreshButton.setOnClickListener {
it.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY)
forceRefresh()
}
binding.shareButton.setOnClickListener {
it.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY)
shareShelter()
}
binding.cacheRetryButton.setOnClickListener {
it.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY)
val loc = currentLocation
if (loc == null) {
Toast.makeText(this, R.string.status_no_location, Toast.LENGTH_SHORT).show()
@ -237,8 +287,24 @@ class MainActivity : AppCompatActivity(), SensorEventListener {
repository.getAllShelters().collectLatest { shelters ->
allShelters = shelters
binding.statusText.text = getString(R.string.status_shelters_loaded, shelters.size)
updateFreshnessIndicator()
updateShelterMarkers()
currentLocation?.let { updateNearestShelters(it) }
// Process pending deep links now that shelter data is available
pendingDeepLinkShelterId?.let { id ->
pendingDeepLinkShelterId = null
val shelter = shelters.find { it.lokalId == id }
if (shelter != null) {
selectShelterByData(shelter)
} else {
Toast.makeText(this@MainActivity, R.string.error_shelter_not_found, Toast.LENGTH_SHORT).show()
}
}
if (currentLocation != null) {
updateNearestShelters(currentLocation!!)
} else {
showWaitingForLocation()
}
}
} catch (e: CancellationException) {
throw e
@ -315,6 +381,7 @@ class MainActivity : AppCompatActivity(), SensorEventListener {
try {
locationProvider.locationUpdates().collectLatest { location ->
currentLocation = location
saveLastLocation(location)
updateNearestShelters(location)
// Center map on first location fix
@ -367,6 +434,7 @@ class MainActivity : AppCompatActivity(), SensorEventListener {
}
updateSelectedShelterUI()
ShelterWidgetProvider.requestUpdate(this)
}
/**
@ -434,7 +502,11 @@ class MainActivity : AppCompatActivity(), SensorEventListener {
/** Update all UI elements for the currently selected shelter. */
private fun updateSelectedShelterUI() {
val selected = selectedShelter ?: return
val distanceText = DistanceUtils.formatDistance(selected.distanceMeters)
val distanceText = if (selected.distanceMeters.isNaN()) {
getString(R.string.status_no_location)
} else {
DistanceUtils.formatDistance(selected.distanceMeters)
}
// Update bottom sheet
binding.selectedShelterAddress.text = selected.shelter.adresse
@ -452,10 +524,11 @@ class MainActivity : AppCompatActivity(), SensorEventListener {
R.string.direction_arrow_description, distanceText
)
// Update compass view
// Update compass view (large arrow gets a north indicator)
binding.compassDistanceText.text = distanceText
binding.compassAddressText.text = selected.shelter.adresse
binding.directionArrow.setDirection(arrowAngle)
binding.directionArrow.setNorthAngle(-deviceHeading)
binding.directionArrow.contentDescription = getString(
R.string.direction_arrow_description, distanceText
)
@ -588,6 +661,7 @@ class MainActivity : AppCompatActivity(), SensorEventListener {
binding.statusText.text = getString(R.string.status_updating)
val success = repository.refreshData()
if (success) {
updateFreshnessIndicator()
Toast.makeText(this@MainActivity, R.string.update_success, Toast.LENGTH_SHORT).show()
} else {
Toast.makeText(this@MainActivity, R.string.update_failed, Toast.LENGTH_SHORT).show()
@ -595,6 +669,59 @@ class MainActivity : AppCompatActivity(), SensorEventListener {
}
}
/**
* Share the currently selected shelter via ACTION_SEND.
* Includes address, capacity, geo: URI, and an HTTPS deep link
* that opens the app (if installed) or the PWA (in browser).
*/
private fun shareShelter() {
val selected = selectedShelter
if (selected == null) {
Toast.makeText(this, R.string.share_no_shelter, Toast.LENGTH_SHORT).show()
return
}
val shelter = selected.shelter
val deepLink = "https://${BuildConfig.DEEP_LINK_DOMAIN}/shelter/${shelter.lokalId}"
val body = getString(
R.string.share_body,
shelter.adresse,
shelter.plasser,
shelter.latitude,
shelter.longitude,
deepLink
)
val shareIntent = Intent(Intent.ACTION_SEND).apply {
type = "text/plain"
putExtra(Intent.EXTRA_SUBJECT, getString(R.string.share_subject))
putExtra(Intent.EXTRA_TEXT, body)
}
startActivity(Intent.createChooser(shareIntent, getString(R.string.action_share)))
}
/** Update the freshness indicator below the status bar with color-coded age. */
private fun updateFreshnessIndicator() {
val lastUpdate = repository.getLastUpdateMs()
if (lastUpdate == 0L) {
binding.dataFreshnessText.visibility = View.GONE
return
}
val daysSince = TimeUnit.MILLISECONDS.toDays(
System.currentTimeMillis() - lastUpdate
).toInt()
val (textRes, colorRes) = when {
daysSince == 0 -> R.string.freshness_fresh to R.color.text_secondary
daysSince <= 7 -> R.string.freshness_week to R.color.shelter_accent
else -> R.string.freshness_old to R.color.shelter_primary
}
binding.dataFreshnessText.text = getString(textRes, daysSince)
binding.dataFreshnessText.setTextColor(ContextCompat.getColor(this, colorRes))
binding.dataFreshnessText.visibility = View.VISIBLE
}
private fun showLoading(message: String) {
binding.loadingOverlay.visibility = View.VISIBLE
binding.loadingText.text = message
@ -606,6 +733,24 @@ class MainActivity : AppCompatActivity(), SensorEventListener {
binding.loadingOverlay.visibility = View.GONE
}
/**
* Show a waiting state in the bottom sheet when shelters are loaded
* but no GPS fix is available yet.
*/
private fun showWaitingForLocation() {
binding.selectedShelterAddress.text = getString(R.string.status_no_location)
binding.selectedShelterDetails.text = getString(R.string.status_shelters_loaded, allShelters.size)
}
/** Persist last GPS fix so the widget can use it even when the app isn't running. */
private fun saveLastLocation(location: Location) {
getSharedPreferences("widget_prefs", Context.MODE_PRIVATE).edit()
.putFloat("last_lat", location.latitude.toFloat())
.putFloat("last_lon", location.longitude.toFloat())
.putLong("last_time", System.currentTimeMillis())
.apply()
}
private fun isNetworkAvailable(): Boolean {
val cm = getSystemService(Context.CONNECTIVITY_SERVICE) as? ConnectivityManager
?: return false
@ -700,6 +845,7 @@ class MainActivity : AppCompatActivity(), SensorEventListener {
val arrowAngle = bearing - deviceHeading
binding.directionArrow.setDirection(arrowAngle)
binding.directionArrow.setNorthAngle(-deviceHeading)
binding.miniArrow.setDirection(arrowAngle)
}
@ -713,9 +859,7 @@ class MainActivity : AppCompatActivity(), SensorEventListener {
Log.w(TAG, "Compass accuracy degraded: $accuracy")
binding.compassAddressText.let { tv ->
val current = selectedShelter?.shelter?.adresse ?: ""
if (!current.contains("")) {
tv.text = "$current"
}
tv.text = getString(R.string.compass_accuracy_warning, current)
}
}
SensorManager.SENSOR_STATUS_ACCURACY_MEDIUM,

View file

@ -7,6 +7,7 @@ import kotlinx.coroutines.CancellationException
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.flow.Flow
import kotlinx.coroutines.withContext
import okhttp3.Interceptor
import okhttp3.OkHttpClient
import okhttp3.Request
import org.json.JSONArray
@ -43,6 +44,11 @@ class ShelterRepository(private val context: Context) {
private val client = OkHttpClient.Builder()
.connectTimeout(30, TimeUnit.SECONDS)
.readTimeout(60, TimeUnit.SECONDS)
.addInterceptor(Interceptor { chain ->
chain.proceed(chain.request().newBuilder()
.header("User-Agent", "Tilfluktsrom/1.8.0")
.build())
})
.build()
/** Reactive stream of all shelters from local cache. */
@ -51,6 +57,9 @@ class ShelterRepository(private val context: Context) {
/** Check if we have cached shelter data. */
suspend fun hasCachedData(): Boolean = dao.count() > 0
/** Timestamp (epoch ms) of the last successful data update, or 0 if never updated. */
fun getLastUpdateMs(): Long = prefs.getLong(KEY_LAST_UPDATE, 0)
/** Check if the cached data is stale and should be refreshed. */
fun isDataStale(): Boolean {
val lastUpdate = prefs.getLong(KEY_LAST_UPDATE, 0)

View file

@ -1,107 +0,0 @@
package no.naiv.tilfluktsrom.location
import android.Manifest
import android.content.Context
import android.content.pm.PackageManager
import android.location.Location
import android.os.Looper
import android.util.Log
import androidx.core.content.ContextCompat
import com.google.android.gms.location.FusedLocationProviderClient
import com.google.android.gms.location.LocationCallback
import com.google.android.gms.location.LocationRequest
import com.google.android.gms.location.LocationResult
import com.google.android.gms.location.LocationServices
import com.google.android.gms.location.Priority
import kotlinx.coroutines.channels.awaitClose
import kotlinx.coroutines.flow.Flow
import kotlinx.coroutines.flow.callbackFlow
/**
* Provides GPS location updates using the Fused Location Provider.
* Emits location updates as a Flow for reactive consumption.
*
* Closes the Flow with a SecurityException if location permission is not granted,
* so callers can detect and handle this failure explicitly.
*/
class LocationProvider(private val context: Context) {
companion object {
private const val TAG = "LocationProvider"
private const val UPDATE_INTERVAL_MS = 5000L
private const val FASTEST_INTERVAL_MS = 2000L
}
private val fusedClient: FusedLocationProviderClient =
LocationServices.getFusedLocationProviderClient(context)
/**
* Stream of location updates. Emits the last known location first (if available),
* then continuous updates. Throws SecurityException if permission is not granted.
*/
fun locationUpdates(): Flow<Location> = callbackFlow {
if (!hasLocationPermission()) {
close(SecurityException("Location permission not granted"))
return@callbackFlow
}
// Try to get last known location for immediate display
try {
fusedClient.lastLocation
.addOnSuccessListener { location ->
if (location != null) {
val result = trySend(location)
if (result.isFailure) {
Log.w(TAG, "Failed to emit last known location")
}
}
}
.addOnFailureListener { e ->
Log.w(TAG, "Could not get last known location", e)
}
} catch (e: SecurityException) {
Log.e(TAG, "SecurityException getting last location", e)
}
val locationRequest = LocationRequest.Builder(
Priority.PRIORITY_HIGH_ACCURACY,
UPDATE_INTERVAL_MS
).apply {
setMinUpdateIntervalMillis(FASTEST_INTERVAL_MS)
setWaitForAccurateLocation(false)
}.build()
val callback = object : LocationCallback() {
override fun onLocationResult(result: LocationResult) {
result.lastLocation?.let { location ->
val sendResult = trySend(location)
if (sendResult.isFailure) {
Log.w(TAG, "Failed to emit location update")
}
}
}
}
try {
fusedClient.requestLocationUpdates(
locationRequest,
callback,
Looper.getMainLooper()
)
} catch (e: SecurityException) {
Log.e(TAG, "SecurityException requesting location updates", e)
close(e)
return@callbackFlow
}
awaitClose {
fusedClient.removeLocationUpdates(callback)
}
}
fun hasLocationPermission(): Boolean {
return ContextCompat.checkSelfPermission(
context, Manifest.permission.ACCESS_FINE_LOCATION
) == PackageManager.PERMISSION_GRANTED
}
}

View file

@ -0,0 +1,43 @@
package no.naiv.tilfluktsrom.ui
import android.os.Bundle
import android.view.LayoutInflater
import android.view.View
import android.view.ViewGroup
import android.view.WindowManager
import androidx.fragment.app.DialogFragment
import no.naiv.tilfluktsrom.R
/**
* Full-screen dialog showing app info, privacy statement, and copyright.
* Static content all text comes from string resources for offline use and i18n.
*/
class AboutDialog : DialogFragment() {
companion object {
const val TAG = "AboutDialog"
}
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setStyle(STYLE_NO_TITLE, R.style.Theme_Tilfluktsrom_Dialog)
}
override fun onCreateView(
inflater: LayoutInflater,
container: ViewGroup?,
savedInstanceState: Bundle?
): View {
return inflater.inflate(R.layout.dialog_about, container, false)
}
override fun onStart() {
super.onStart()
dialog?.window?.apply {
setLayout(
WindowManager.LayoutParams.MATCH_PARENT,
WindowManager.LayoutParams.WRAP_CONTENT
)
}
}
}

View file

@ -0,0 +1,50 @@
package no.naiv.tilfluktsrom.ui
import android.os.Bundle
import android.view.LayoutInflater
import android.view.View
import android.view.ViewGroup
import android.view.WindowManager
import androidx.fragment.app.DialogFragment
import no.naiv.tilfluktsrom.R
/**
* Full-screen dialog showing civil defense instructions.
* Static content all text comes from string resources for offline use and i18n.
*/
class CivilDefenseInfoDialog : DialogFragment() {
companion object {
const val TAG = "CivilDefenseInfoDialog"
}
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setStyle(STYLE_NO_TITLE, R.style.Theme_Tilfluktsrom_Dialog)
}
override fun onCreateView(
inflater: LayoutInflater,
container: ViewGroup?,
savedInstanceState: Bundle?
): View {
return inflater.inflate(R.layout.dialog_civil_defense, container, false)
}
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
super.onViewCreated(view, savedInstanceState)
view.findViewById<View>(R.id.aboutLink)?.setOnClickListener {
AboutDialog().show(parentFragmentManager, AboutDialog.TAG)
}
}
override fun onStart() {
super.onStart()
dialog?.window?.apply {
setLayout(
WindowManager.LayoutParams.MATCH_PARENT,
WindowManager.LayoutParams.WRAP_CONTENT
)
}
}
}

View file

@ -17,6 +17,9 @@ import no.naiv.tilfluktsrom.R
* rotationAngle = shelterBearing - deviceHeading
* This gives the direction the user needs to walk, adjusted for which
* way they're currently facing.
*
* Optionally draws a discrete north indicator on the perimeter so users
* can validate compass calibration against a known direction.
*/
class DirectionArrowView @JvmOverloads constructor(
context: Context,
@ -25,6 +28,7 @@ class DirectionArrowView @JvmOverloads constructor(
) : View(context, attrs, defStyleAttr) {
private var rotationAngle = 0f
private var northAngle = Float.NaN
private val arrowPaint = Paint(Paint.ANTI_ALIAS_FLAG).apply {
color = context.getColor(R.color.shelter_primary)
@ -37,7 +41,18 @@ class DirectionArrowView @JvmOverloads constructor(
strokeWidth = 4f
}
private val northPaint = Paint(Paint.ANTI_ALIAS_FLAG).apply {
color = 0x99CFD8DC.toInt() // text_secondary at ~60% opacity
style = Paint.Style.FILL
}
private val northTextPaint = Paint(Paint.ANTI_ALIAS_FLAG).apply {
color = 0x99CFD8DC.toInt()
textAlign = Paint.Align.CENTER
}
private val arrowPath = Path()
private val northPath = Path()
/**
* Set the rotation angle in degrees.
@ -48,6 +63,16 @@ class DirectionArrowView @JvmOverloads constructor(
invalidate()
}
/**
* Set the angle to north in the view's coordinate space.
* This is typically -deviceHeading (where north is on screen).
* Set to Float.NaN to hide the north indicator.
*/
fun setNorthAngle(degrees: Float) {
northAngle = degrees
invalidate()
}
override fun onDraw(canvas: Canvas) {
super.onDraw(canvas)
@ -55,6 +80,11 @@ class DirectionArrowView @JvmOverloads constructor(
val cy = height / 2f
val size = minOf(width, height) * 0.4f
// Draw north indicator first (behind the main arrow)
if (!northAngle.isNaN()) {
drawNorthIndicator(canvas, cx, cy, size)
}
canvas.save()
canvas.rotate(rotationAngle, cx, cy)
@ -74,4 +104,32 @@ class DirectionArrowView @JvmOverloads constructor(
canvas.restore()
}
/**
* Draw a small north indicator: a tiny triangle and "N" label
* placed on the perimeter of the view, pointing inward toward center.
*/
private fun drawNorthIndicator(canvas: Canvas, cx: Float, cy: Float, arrowSize: Float) {
val radius = arrowSize * 1.35f
val tickSize = arrowSize * 0.1f
// Scale "N" text relative to the view
northTextPaint.textSize = arrowSize * 0.18f
canvas.save()
canvas.rotate(northAngle, cx, cy)
// Small triangle at the top of the perimeter circle
northPath.reset()
northPath.moveTo(cx, cy - radius)
northPath.lineTo(cx - tickSize, cy - radius - tickSize * 1.8f)
northPath.lineTo(cx + tickSize, cy - radius - tickSize * 1.8f)
northPath.close()
canvas.drawPath(northPath, northPaint)
// "N" label just outside the triangle
canvas.drawText("N", cx, cy - radius - tickSize * 2.2f, northTextPaint)
canvas.restore()
}
}

View file

@ -1,5 +1,6 @@
package no.naiv.tilfluktsrom.ui
import android.view.HapticFeedbackConstants
import android.view.LayoutInflater
import android.view.ViewGroup
import androidx.recyclerview.widget.DiffUtil
@ -52,10 +53,18 @@ class ShelterListAdapter(
R.string.shelter_room_nr, item.shelter.romnr
)
binding.root.contentDescription = ctx.getString(
R.string.content_desc_shelter_item,
item.shelter.adresse,
DistanceUtils.formatDistance(item.distanceMeters),
item.shelter.plasser
)
binding.root.isSelected = isSelected
binding.root.alpha = if (isSelected) 1.0f else 0.7f
binding.root.setOnClickListener {
it.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY)
val pos = adapterPosition
if (pos != RecyclerView.NO_POSITION) {
selectPosition(pos)

View file

@ -0,0 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- Material Design info icon -->
<vector xmlns:android="http://schemas.android.com/apk/res/android"
android:width="24dp"
android:height="24dp"
android:viewportWidth="24"
android:viewportHeight="24">
<path
android:fillColor="#FFFFFF"
android:pathData="M12,2C6.48,2 2,6.48 2,12s4.48,10 10,10 10,-4.48 10,-10S17.52,2 12,2zM13,17h-2v-6h2v6zM13,9h-2V7h2v2z" />
</vector>

View file

@ -0,0 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- Material Design share icon -->
<vector xmlns:android="http://schemas.android.com/apk/res/android"
android:width="24dp"
android:height="24dp"
android:viewportWidth="24"
android:viewportHeight="24">
<path
android:fillColor="#FFFFFF"
android:pathData="M18,16.08c-0.76,0 -1.44,0.3 -1.96,0.77L8.91,12.7c0.05,-0.23 0.09,-0.46 0.09,-0.7s-0.04,-0.47 -0.09,-0.7l7.05,-4.11c0.54,0.5 1.25,0.81 2.04,0.81 1.66,0 3,-1.34 3,-3s-1.34,-3 -3,-3 -3,1.34 -3,3c0,0.24 0.04,0.47 0.09,0.7L8.04,9.81C7.5,9.31 6.79,9 6,9c-1.66,0 -3,1.34 -3,3s1.34,3 3,3c0.79,0 1.5,-0.31 2.04,-0.81l7.12,4.16c-0.05,0.21 -0.08,0.43 -0.08,0.65 0,1.61 1.31,2.92 2.92,2.92 1.61,0 2.92,-1.31 2.92,-2.92s-1.31,-2.92 -2.92,-2.92z" />
</vector>

View file

@ -15,28 +15,56 @@
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:background="@color/status_bar_bg"
android:gravity="center_vertical"
android:orientation="horizontal"
android:padding="8dp"
android:orientation="vertical"
app:layout_constraintTop_toTopOf="parent">
<TextView
android:id="@+id/statusText"
android:layout_width="0dp"
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_weight="1"
android:textColor="@color/status_text"
android:textSize="12sp"
tools:text="@string/status_ready" />
android:gravity="center_vertical"
android:orientation="horizontal"
android:paddingHorizontal="8dp"
android:paddingVertical="4dp">
<ImageButton
android:id="@+id/refreshButton"
android:layout_width="36dp"
android:layout_height="36dp"
android:background="?attr/selectableItemBackgroundBorderless"
android:contentDescription="@string/action_refresh"
android:src="@drawable/ic_refresh"
app:tint="@color/status_text" />
<TextView
android:id="@+id/statusText"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="1"
android:accessibilityLiveRegion="polite"
android:textColor="@color/status_text"
android:textSize="12sp"
tools:text="@string/status_ready" />
<ImageButton
android:id="@+id/infoButton"
android:layout_width="48dp"
android:layout_height="48dp"
android:background="?attr/selectableItemBackgroundBorderless"
android:contentDescription="@string/action_civil_defense_info"
android:src="@drawable/ic_info"
app:tint="@color/status_text" />
<ImageButton
android:id="@+id/refreshButton"
android:layout_width="48dp"
android:layout_height="48dp"
android:background="?attr/selectableItemBackgroundBorderless"
android:contentDescription="@string/action_refresh"
android:src="@drawable/ic_refresh"
app:tint="@color/status_text" />
</LinearLayout>
<TextView
android:id="@+id/dataFreshnessText"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:paddingHorizontal="8dp"
android:paddingBottom="4dp"
android:textSize="11sp"
android:visibility="gone"
tools:text="Data is up to date"
tools:visibility="visible" />
</LinearLayout>
<!-- Map view (main content) -->
@ -44,6 +72,7 @@
android:id="@+id/mapView"
android:layout_width="match_parent"
android:layout_height="0dp"
android:contentDescription="@string/a11y_map"
app:layout_constraintTop_toBottomOf="@id/statusBar"
app:layout_constraintBottom_toTopOf="@id/bottomSheet" />
@ -53,6 +82,7 @@
android:layout_width="match_parent"
android:layout_height="0dp"
android:background="@color/compass_bg"
android:contentDescription="@string/a11y_compass"
android:visibility="gone"
app:layout_constraintTop_toBottomOf="@id/statusBar"
app:layout_constraintBottom_toTopOf="@id/bottomSheet">
@ -193,6 +223,16 @@
android:textSize="13sp"
tools:text="1.2 km - 400 plasser - Rom 776" />
</LinearLayout>
<ImageButton
android:id="@+id/shareButton"
android:layout_width="48dp"
android:layout_height="48dp"
android:layout_marginStart="8dp"
android:background="?attr/selectableItemBackgroundBorderless"
android:contentDescription="@string/action_share"
android:src="@drawable/ic_share"
app:tint="@color/text_secondary" />
</LinearLayout>
<!-- Nearest shelters list -->
@ -212,6 +252,8 @@
android:background="@color/loading_bg"
android:clickable="true"
android:focusable="true"
android:importantForAccessibility="yes"
android:accessibilityLiveRegion="assertive"
android:visibility="gone">
<LinearLayout
@ -225,6 +267,7 @@
android:id="@+id/loadingProgress"
android:layout_width="64dp"
android:layout_height="64dp"
android:contentDescription="@string/status_loading"
android:indeterminate="true" />
<TextView

View file

@ -0,0 +1,104 @@
<?xml version="1.0" encoding="utf-8"?>
<ScrollView xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="@color/status_bar_bg"
android:padding="20dp">
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="vertical">
<!-- Title -->
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginBottom="16dp"
android:text="@string/about_title"
android:textColor="@color/shelter_primary"
android:textSize="20sp"
android:textStyle="bold" />
<!-- App description -->
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginBottom="16dp"
android:text="@string/about_description"
android:textColor="@color/text_secondary"
android:textSize="14sp" />
<!-- Privacy section -->
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginBottom="4dp"
android:text="@string/about_privacy_title"
android:textColor="@color/text_primary"
android:textSize="16sp"
android:textStyle="bold" />
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginBottom="16dp"
android:text="@string/about_privacy_body"
android:textColor="@color/text_secondary"
android:textSize="14sp" />
<!-- Data sources section -->
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginBottom="4dp"
android:text="@string/about_data_title"
android:textColor="@color/text_primary"
android:textSize="16sp"
android:textStyle="bold" />
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginBottom="16dp"
android:text="@string/about_data_body"
android:textColor="@color/text_secondary"
android:textSize="14sp" />
<!-- Stored on device section -->
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginBottom="4dp"
android:text="@string/about_stored_title"
android:textColor="@color/text_primary"
android:textSize="16sp"
android:textStyle="bold" />
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginBottom="24dp"
android:text="@string/about_stored_body"
android:textColor="@color/text_secondary"
android:textSize="14sp" />
<!-- Copyright -->
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/app_copyright"
android:textColor="@color/text_secondary"
android:textSize="11sp" />
<!-- Open source -->
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="4dp"
android:text="@string/about_open_source"
android:textColor="@color/text_secondary"
android:textSize="11sp" />
</LinearLayout>
</ScrollView>

View file

@ -0,0 +1,129 @@
<?xml version="1.0" encoding="utf-8"?>
<ScrollView xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="@color/status_bar_bg"
android:padding="20dp">
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="vertical">
<!-- Title -->
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginBottom="16dp"
android:text="@string/civil_defense_title"
android:textColor="@color/shelter_primary"
android:textSize="20sp"
android:textStyle="bold" />
<!-- Step 1: The alarm signal -->
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/civil_defense_step1_title"
android:textColor="@color/text_primary"
android:textSize="16sp"
android:textStyle="bold" />
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginBottom="12dp"
android:text="@string/civil_defense_step1_body"
android:textColor="@color/text_secondary"
android:textSize="14sp" />
<!-- Step 2: Go indoors -->
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/civil_defense_step2_title"
android:textColor="@color/text_primary"
android:textSize="16sp"
android:textStyle="bold" />
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginBottom="12dp"
android:text="@string/civil_defense_step2_body"
android:textColor="@color/text_secondary"
android:textSize="14sp" />
<!-- Step 3: Find nearest shelter -->
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/civil_defense_step3_title"
android:textColor="@color/text_primary"
android:textSize="16sp"
android:textStyle="bold" />
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginBottom="12dp"
android:text="@string/civil_defense_step3_body"
android:textColor="@color/text_secondary"
android:textSize="14sp" />
<!-- Step 4: Listen to NRK P1 -->
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/civil_defense_step4_title"
android:textColor="@color/text_primary"
android:textSize="16sp"
android:textStyle="bold" />
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginBottom="12dp"
android:text="@string/civil_defense_step4_body"
android:textColor="@color/text_secondary"
android:textSize="14sp" />
<!-- Step 5: All clear signal -->
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/civil_defense_step5_title"
android:textColor="@color/text_primary"
android:textSize="16sp"
android:textStyle="bold" />
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginBottom="16dp"
android:text="@string/civil_defense_step5_body"
android:textColor="@color/text_secondary"
android:textSize="14sp" />
<!-- Source attribution -->
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/civil_defense_source"
android:textColor="@color/text_secondary"
android:textSize="12sp"
android:textStyle="italic" />
<!-- About link -->
<TextView
android:id="@+id/aboutLink"
android:layout_width="wrap_content"
android:layout_height="48dp"
android:layout_marginTop="8dp"
android:gravity="center_vertical"
android:text="@string/action_about"
android:textColor="@color/shelter_primary"
android:textSize="14sp" />
</LinearLayout>
</ScrollView>

View file

@ -0,0 +1,74 @@
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/widgetRoot"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="@color/background"
android:gravity="center_vertical"
android:orientation="horizontal"
android:padding="8dp">
<ImageView
android:id="@+id/widgetIcon"
android:layout_width="40dp"
android:layout_height="40dp"
android:contentDescription="@string/nearest_shelter"
android:src="@drawable/ic_shelter" />
<LinearLayout
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_marginStart="8dp"
android:layout_weight="1"
android:orientation="vertical">
<TextView
android:id="@+id/widgetAddress"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:ellipsize="end"
android:maxLines="1"
android:textColor="@color/text_primary"
android:textSize="14sp"
android:textStyle="bold"
tools:text="Storgata 1" />
<TextView
android:id="@+id/widgetDetails"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:ellipsize="end"
android:maxLines="1"
android:textColor="@color/text_secondary"
android:textSize="12sp"
tools:text="400 places" />
<TextView
android:id="@+id/widgetTimestamp"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:textColor="@color/text_secondary"
android:textSize="9sp"
tools:text="14:32" />
</LinearLayout>
<TextView
android:id="@+id/widgetDistance"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginStart="8dp"
android:textColor="@color/shelter_primary"
android:textSize="18sp"
android:textStyle="bold"
tools:text="1.2 km" />
<ImageView
android:id="@+id/widgetRefreshButton"
android:layout_width="48dp"
android:layout_height="48dp"
android:layout_marginStart="4dp"
android:padding="8dp"
android:contentDescription="@string/action_refresh"
android:src="@drawable/ic_refresh" />
</LinearLayout>

View file

@ -30,6 +30,7 @@
<string name="action_cache_ok">Lagre kart</string>
<string name="action_cache_now">Lagre nå</string>
<string name="action_reset_navigation">Tilbakestill navigasjonsvisning</string>
<string name="action_share">Del tilfluktsrom</string>
<string name="warning_no_map_cache">Ingen frakoblet kart lagret. Kartet krever internett.</string>
<!-- Tillatelser -->
@ -41,9 +42,61 @@
<string name="error_download_failed">Kunne ikke laste ned tilfluktsromdata. Sjekk internettforbindelsen.</string>
<string name="error_no_data_offline">Ingen lagrede data tilgjengelig. Koble til internett for å laste ned tilfluktsromdata.</string>
<string name="error_no_compass">Kompass er ikke tilgjengelig på denne enheten</string>
<string name="error_shelter_not_found">Fant ikke tilfluktsrommet</string>
<string name="update_success">Tilfluktsromdata oppdatert</string>
<string name="update_failed">Oppdatering mislyktes — bruker lagrede data</string>
<!-- Widget -->
<string name="widget_description">Viser n\u00e6rmeste tilfluktsrom med avstand</string>
<string name="widget_open_app">\u00c5pne appen for posisjon</string>
<string name="widget_no_data">Ingen tilfluktsromdata</string>
<string name="widget_no_location">Trykk for \u00e5 oppdatere</string>
<string name="widget_updated_at">Oppdatert %s</string>
<!-- Dataferskhet -->
<string name="freshness_fresh">Data er oppdatert</string>
<string name="freshness_week">Data er %d dager gammel</string>
<string name="freshness_old">Data er utdatert</string>
<!-- Deling -->
<string name="share_subject">Tilfluktsrom</string>
<string name="share_body">Tilfluktsrom: %1$s\n%2$d plasser\n%3$.6f, %4$.6f\ngeo:%3$.6f,%4$.6f\n%5$s</string>
<string name="share_no_shelter">Ingen tilfluktsrom valgt</string>
<!-- Tilgjengelighet -->
<string name="direction_arrow_description">Retning til tilfluktsrom, %s unna</string>
<string name="content_desc_shelter_item">%1$s, %2$s, %3$d plasser</string>
<string name="compass_accuracy_warning">Upresist kompass - %s</string>
<string name="a11y_map">Tilfluktsromkart</string>
<string name="a11y_compass">Kompassnavigasjon</string>
<!-- Sivilforsvar -->
<string name="action_civil_defense_info">Sivilforsvarsinformasjon</string>
<string name="civil_defense_title">Hva du skal gjøre hvis alarmen går</string>
<string name="civil_defense_step1_title">1. Viktig melding-signalet</string>
<string name="civil_defense_step1_body">Tre serier med korte støt med ett minutts stillhet mellom hver serie. Dette betyr: søk informasjon umiddelbart. Slå på DAB-radio, TV, eller sjekk offisielle kilder på nett.</string>
<string name="civil_defense_step2_title">2. Flyalarm</string>
<string name="civil_defense_step2_body">Korte støt som varer omtrent ett minutt. Dette betyr umiddelbar fare for angrep — søk dekning nå. Gå til nærmeste tilfluktsrom, kjeller eller innerrom umiddelbart.</string>
<string name="civil_defense_step3_title">3. Gå innendørs og finn dekning</string>
<string name="civil_defense_step3_body">Kom deg innendørs. Lukk alle vinduer, dører og ventilasjonsåpninger. Bruk denne appen for å finne nærmeste offentlige tilfluktsrom. Kompasset og kartet fungerer uten internett. Hvis det ikke er noe tilfluktsrom i nærheten, gå til en kjeller eller et innerrom bort fra vinduer.</string>
<string name="civil_defense_step4_title">4. Lytt til NRK på DAB-radio</string>
<string name="civil_defense_step4_body">Lytt til NRK P1 på DAB-radio for offisielle oppdateringer og instruksjoner fra myndighetene. DAB-radio fungerer selv når mobilnettet og internett er nede. Ha en batteridrevet eller sveivbar DAB-radio som del av beredskapsutstyret ditt.</string>
<string name="civil_defense_step5_title">5. Faren over</string>
<string name="civil_defense_step5_body">Én sammenhengende tone på omtrent 30 sekunder. Faren eller angrepet er over. Fortsett å følge instruksjoner fra myndighetene.</string>
<string name="civil_defense_source">Kilde: DSB (Direktoratet for samfunnssikkerhet og beredskap)</string>
<!-- Om -->
<string name="about_title">Om Tilfluktsrom</string>
<string name="about_description">Tilfluktsrom hjelper deg med å finne nærmeste offentlige tilfluktsrom i Norge. Appen er laget for å fungere uten internett etter første oppsett — du trenger ikke nett for å finne tilfluktsrom, navigere med kompass eller dele posisjonen din.</string>
<string name="about_privacy_title">Personvern</string>
<string name="about_privacy_body">Denne appen samler ikke inn, sender eller deler noen personopplysninger. Det finnes ingen analyse, sporing eller tredjepartstjenester.\n\nGPS-posisjonen din brukes bare lokalt på enheten din for å finne tilfluktsrom i nærheten, og sendes aldri til noen server.</string>
<string name="about_data_title">Datakilder</string>
<string name="about_data_body">Tilfluktsromdata er offentlig informasjon fra DSB (Direktoratet for samfunnssikkerhet og beredskap), distribuert via Geonorge. Kartfliser lastes fra OpenStreetMap. Begge lagres lokalt for frakoblet bruk.</string>
<string name="about_stored_title">Lagret på enheten din</string>
<string name="about_stored_body">• Tilfluktsromdatabase (offentlige data fra DSB)\n• Kartfliser for frakoblet bruk\n• Din siste GPS-posisjon (for hjemmeskjerm-widgeten)\n\nIngen data forlater enheten din bortsett fra forespørsler om å laste ned tilfluktsromdata og kartfliser.</string>
<string name="about_open_source">Åpen kildekode — kode.naiv.no/olemd/tilfluktsrom</string>
<string name="action_about">Om denne appen</string>
<!-- Opphavsrett -->
<string name="app_copyright">Opphavsrett © Ole-Morten Duesund</string>
</resources>

View file

@ -30,6 +30,7 @@
<string name="action_cache_ok">Lagre kart</string>
<string name="action_cache_now">Lagre no</string>
<string name="action_reset_navigation">Tilbakestill navigasjonsvising</string>
<string name="action_share">Del tilfluktsrom</string>
<string name="warning_no_map_cache">Ingen fråkopla kart lagra. Kartet krev internett.</string>
<!-- Løyve -->
@ -41,9 +42,61 @@
<string name="error_download_failed">Kunne ikkje laste ned tilfluktsromdata. Sjekk internettilkoplinga.</string>
<string name="error_no_data_offline">Ingen lagra data tilgjengeleg. Kopla til internett for å laste ned tilfluktsromdata.</string>
<string name="error_no_compass">Kompass er ikkje tilgjengeleg på denne eininga</string>
<string name="error_shelter_not_found">Fann ikkje tilfluktsrommet</string>
<string name="update_success">Tilfluktsromdata oppdatert</string>
<string name="update_failed">Oppdatering mislukkast — brukar lagra data</string>
<!-- Widget -->
<string name="widget_description">Viser n\u00e6raste tilfluktsrom med avstand</string>
<string name="widget_open_app">Opne appen for posisjon</string>
<string name="widget_no_data">Ingen tilfluktsromdata</string>
<string name="widget_no_location">Trykk for \u00e5 oppdatere</string>
<string name="widget_updated_at">Oppdatert %s</string>
<!-- Dataferskheit -->
<string name="freshness_fresh">Data er oppdatert</string>
<string name="freshness_week">Data er %d dagar gammal</string>
<string name="freshness_old">Data er utdatert</string>
<!-- Deling -->
<string name="share_subject">Tilfluktsrom</string>
<string name="share_body">Tilfluktsrom: %1$s\n%2$d plassar\n%3$.6f, %4$.6f\ngeo:%3$.6f,%4$.6f\n%5$s</string>
<string name="share_no_shelter">Ingen tilfluktsrom valt</string>
<!-- Tilgjenge -->
<string name="direction_arrow_description">Retning til tilfluktsrom, %s unna</string>
<string name="content_desc_shelter_item">%1$s, %2$s, %3$d plassar</string>
<string name="compass_accuracy_warning">Upresis kompass - %s</string>
<string name="a11y_map">Tilfluktsromkart</string>
<string name="a11y_compass">Kompassnavigasjon</string>
<!-- Sivilforsvar -->
<string name="action_civil_defense_info">Sivilforsvarsinformasjon</string>
<string name="civil_defense_title">Kva du skal gjere om alarmen går</string>
<string name="civil_defense_step1_title">1. Viktig melding-signalet</string>
<string name="civil_defense_step1_body">Tre seriar med korte støyt med eitt minutt stille mellom kvar serie. Dette tyder: søk informasjon med ein gong. Slå på DAB-radio, TV, eller sjekk offisielle kjelder på nett.</string>
<string name="civil_defense_step2_title">2. Flyalarm</string>
<string name="civil_defense_step2_body">Korte støyt som varar omtrent eitt minutt. Dette tyder umiddelbar fare for åtak — søk dekning no. Gå til næraste tilfluktsrom, kjellar eller innerrom med ein gong.</string>
<string name="civil_defense_step3_title">3. Gå innandørs og finn dekning</string>
<string name="civil_defense_step3_body">Kom deg innandørs. Lukk alle vindauge, dører og ventilasjonsopningar. Bruk denne appen for å finne næraste offentlege tilfluktsrom. Kompasset og kartet fungerer utan internett. Om det ikkje er noko tilfluktsrom i nærleiken, gå til ein kjellar eller eit innerrom bort frå vindauge.</string>
<string name="civil_defense_step4_title">4. Lytt til NRK på DAB-radio</string>
<string name="civil_defense_step4_body">Lytt til NRK P1 på DAB-radio for offisielle oppdateringar og instruksjonar frå styresmaktene. DAB-radio fungerer sjølv når mobilnettet og internett er nede. Ha ein batteridrive eller sveivbar DAB-radio som del av beredskapsutstyret ditt.</string>
<string name="civil_defense_step5_title">5. Faren over</string>
<string name="civil_defense_step5_body">Éin samanhengande tone på omtrent 30 sekund. Faren eller åtaket er over. Hald fram med å følgje instruksjonar frå styresmaktene.</string>
<string name="civil_defense_source">Kjelde: DSB (Direktoratet for samfunnstryggleik og beredskap)</string>
<!-- Om -->
<string name="about_title">Om Tilfluktsrom</string>
<string name="about_description">Tilfluktsrom hjelper deg med å finne næraste offentlege tilfluktsrom i Noreg. Appen er laga for å fungere utan internett etter fyrste oppsett — du treng ikkje nett for å finne tilfluktsrom, navigere med kompass eller dele posisjonen din.</string>
<string name="about_privacy_title">Personvern</string>
<string name="about_privacy_body">Denne appen samlar ikkje inn, sender eller deler nokon personopplysingar. Det finst ingen analyse, sporing eller tredjepartstenester.\n\nGPS-posisjonen din vert berre brukt lokalt på eininga di for å finne tilfluktsrom i nærleiken, og vert aldri sendt til nokon tenar.</string>
<string name="about_data_title">Datakjelder</string>
<string name="about_data_body">Tilfluktsromdata er offentleg informasjon frå DSB (Direktoratet for samfunnstryggleik og beredskap), distribuert via Geonorge. Kartfliser vert lasta frå OpenStreetMap. Begge vert lagra lokalt for fråkopla bruk.</string>
<string name="about_stored_title">Lagra på eininga di</string>
<string name="about_stored_body">• Tilfluktsromdatabase (offentlege data frå DSB)\n• Kartfliser for fråkopla bruk\n• Din siste GPS-posisjon (for heimeskjerm-widgeten)\n\nIngen data forlèt eininga di bortsett frå førespurnader om å laste ned tilfluktsromdata og kartfliser.</string>
<string name="about_open_source">Open kjeldekode — kode.naiv.no/olemd/tilfluktsrom</string>
<string name="action_about">Om denne appen</string>
<!-- Opphavsrett -->
<string name="app_copyright">Opphavsrett © Ole-Morten Duesund</string>
</resources>

View file

@ -7,7 +7,7 @@
<color name="background">#1A1A2E</color>
<color name="status_bar_bg">#16213E</color>
<color name="status_text">#B0BEC5</color>
<color name="status_text">#CFD8DC</color>
<color name="bottom_sheet_bg">#1A1A2E</color>
<color name="compass_bg">#0F0F23</color>
<color name="loading_bg">#CC000000</color>

View file

@ -30,6 +30,7 @@
<string name="action_cache_ok">Cache map</string>
<string name="action_cache_now">Cache now</string>
<string name="action_reset_navigation">Reset navigation view</string>
<string name="action_share">Share shelter</string>
<string name="warning_no_map_cache">No offline map cached. Map requires internet.</string>
<!-- Permissions -->
@ -41,9 +42,61 @@
<string name="error_download_failed">Could not download shelter data. Check your internet connection.</string>
<string name="error_no_data_offline">No cached data available. Connect to the internet to download shelter data.</string>
<string name="error_no_compass">Compass not available on this device</string>
<string name="error_shelter_not_found">Shelter not found</string>
<string name="update_success">Shelter data updated</string>
<string name="update_failed">Update failed — using cached data</string>
<!-- Widget -->
<string name="widget_description">Shows nearest shelter with distance</string>
<string name="widget_open_app">Open app for location</string>
<string name="widget_no_data">No shelter data</string>
<string name="widget_no_location">Tap to refresh</string>
<string name="widget_updated_at">Updated %s</string>
<!-- Data freshness -->
<string name="freshness_fresh">Data is up to date</string>
<string name="freshness_week">Data is %d days old</string>
<string name="freshness_old">Data is outdated</string>
<!-- Sharing -->
<string name="share_subject">Emergency shelter</string>
<string name="share_body">Shelter: %1$s\n%2$d places\n%3$.6f, %4$.6f\ngeo:%3$.6f,%4$.6f\n%5$s</string>
<string name="share_no_shelter">No shelter selected</string>
<!-- Accessibility -->
<string name="direction_arrow_description">Direction to shelter, %s away</string>
<string name="content_desc_shelter_item">%1$s, %2$s, %3$d places</string>
<string name="compass_accuracy_warning">Low accuracy - %s</string>
<string name="a11y_map">Shelter map</string>
<string name="a11y_compass">Compass navigation</string>
<!-- Civil defense info -->
<string name="action_civil_defense_info">Civil defense information</string>
<string name="civil_defense_title">What to do if the alarm sounds</string>
<string name="civil_defense_step1_title">1. Important message signal</string>
<string name="civil_defense_step1_body">Three series of short blasts with one minute of silence between each series. This means: seek information immediately. Turn on DAB radio, TV, or check official sources online.</string>
<string name="civil_defense_step2_title">2. Air raid alarm</string>
<string name="civil_defense_step2_body">Short blasts lasting approximately one minute. This means immediate danger of attack — seek shelter now. Go to the nearest shelter, basement, or inner room immediately.</string>
<string name="civil_defense_step3_title">3. Go indoors and find shelter</string>
<string name="civil_defense_step3_body">Get indoors. Close all windows, doors, and ventilation openings. Use this app to find the nearest public shelter (tilfluktsrom). The compass and map work offline. If no shelter is nearby, go to a basement or an inner room away from windows.</string>
<string name="civil_defense_step4_title">4. Listen to NRK on DAB radio</string>
<string name="civil_defense_step4_body">Tune in to NRK P1 on DAB radio for official updates and instructions from authorities. DAB radio works even when mobile networks and the internet are down. Keep a battery-powered or hand-crank DAB radio as part of your emergency kit.</string>
<string name="civil_defense_step5_title">5. All clear</string>
<string name="civil_defense_step5_body">One continuous tone lasting approximately 30 seconds. The danger or attack is over. Continue to follow instructions from authorities.</string>
<string name="civil_defense_source">Source: DSB (Norwegian Directorate for Civil Protection)</string>
<!-- About -->
<string name="about_title">About Tilfluktsrom</string>
<string name="about_description">Tilfluktsrom helps you find the nearest public shelter in Norway. The app is designed to work offline after initial setup — no internet required to find shelters, navigate by compass, or share your location.</string>
<string name="about_privacy_title">Privacy</string>
<string name="about_privacy_body">This app does not collect, transmit, or share any personal data. There are no analytics, tracking, or third-party services.\n\nYour GPS location is used only on your device to find nearby shelters and is never sent to any server.</string>
<string name="about_data_title">Data sources</string>
<string name="about_data_body">Shelter data is public information from DSB (Norwegian Directorate for Civil Protection), distributed via Geonorge. Map tiles are loaded from OpenStreetMap. Both are cached locally for offline use.</string>
<string name="about_stored_title">Stored on your device</string>
<string name="about_stored_body">• Shelter database (public data from DSB)\n• Map tiles for offline use\n• Your last GPS position (for the home screen widget)\n\nNo data leaves your device except requests to download shelter data and map tiles.</string>
<string name="about_open_source">Open source — kode.naiv.no/olemd/tilfluktsrom</string>
<string name="action_about">About this app</string>
<!-- Copyright -->
<string name="app_copyright">Copyright © Ole-Morten Duesund</string>
</resources>

View file

@ -8,4 +8,9 @@
<item name="android:statusBarColor">@color/status_bar_bg</item>
<item name="android:navigationBarColor">@color/background</item>
</style>
<style name="Theme.Tilfluktsrom.Dialog" parent="Theme.Material3.Dark.Dialog">
<item name="android:windowBackground">@color/status_bar_bg</item>
<item name="android:backgroundDimEnabled">true</item>
</style>
</resources>

View file

@ -0,0 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
android:minWidth="250dp"
android:minHeight="40dp"
android:updatePeriodMillis="0"
android:initialLayout="@layout/widget_nearest_shelter"
android:resizeMode="horizontal"
android:widgetCategory="home_screen"
android:description="@string/widget_description" />

View file

@ -0,0 +1,203 @@
package no.naiv.tilfluktsrom.location
import android.Manifest
import android.content.Context
import android.content.pm.PackageManager
import android.location.Location
import android.location.LocationListener
import android.location.LocationManager
import android.os.Bundle
import android.os.Looper
import android.util.Log
import androidx.core.content.ContextCompat
import com.google.android.gms.common.ConnectionResult
import com.google.android.gms.common.GoogleApiAvailability
import com.google.android.gms.location.FusedLocationProviderClient
import com.google.android.gms.location.LocationCallback
import com.google.android.gms.location.LocationRequest
import com.google.android.gms.location.LocationResult
import com.google.android.gms.location.LocationServices
import com.google.android.gms.location.Priority
import kotlinx.coroutines.channels.awaitClose
import kotlinx.coroutines.flow.Flow
import kotlinx.coroutines.flow.callbackFlow
/**
* Provides GPS location updates with automatic fallback.
*
* Uses FusedLocationProviderClient when Google Play Services is available (most devices),
* and falls back to LocationManager (GPS + Network providers) for degoogled/F-Droid devices.
*
* The public API is identical regardless of backend: locationUpdates() emits a Flow<Location>.
*/
class LocationProvider(private val context: Context) {
companion object {
private const val TAG = "LocationProvider"
private const val UPDATE_INTERVAL_MS = 5000L
private const val FASTEST_INTERVAL_MS = 2000L
}
/** Checked once at construction — Play Services availability won't change at runtime. */
private val usePlayServices: Boolean = isPlayServicesAvailable()
init {
Log.d(TAG, "Location backend: ${if (usePlayServices) "Play Services" else "LocationManager"}")
}
/**
* Stream of location updates. Emits the last known location first (if available),
* then continuous updates. Throws SecurityException if permission is not granted.
*/
fun locationUpdates(): Flow<Location> = callbackFlow {
if (!hasLocationPermission()) {
close(SecurityException("Location permission not granted"))
return@callbackFlow
}
if (usePlayServices) {
val fusedClient: FusedLocationProviderClient =
LocationServices.getFusedLocationProviderClient(context)
// Emit last known location immediately for fast first display
try {
fusedClient.lastLocation
.addOnSuccessListener { location ->
if (location != null) {
val result = trySend(location)
if (result.isFailure) {
Log.w(TAG, "Failed to emit last known location")
}
}
}
.addOnFailureListener { e ->
Log.w(TAG, "Could not get last known location", e)
}
} catch (e: SecurityException) {
Log.e(TAG, "SecurityException getting last location", e)
}
val locationRequest = LocationRequest.Builder(
Priority.PRIORITY_HIGH_ACCURACY,
UPDATE_INTERVAL_MS
).apply {
setMinUpdateIntervalMillis(FASTEST_INTERVAL_MS)
setWaitForAccurateLocation(false)
}.build()
val callback = object : LocationCallback() {
override fun onLocationResult(result: LocationResult) {
result.lastLocation?.let { location ->
val sendResult = trySend(location)
if (sendResult.isFailure) {
Log.w(TAG, "Failed to emit location update")
}
}
}
}
try {
fusedClient.requestLocationUpdates(
locationRequest,
callback,
Looper.getMainLooper()
)
} catch (e: SecurityException) {
Log.e(TAG, "SecurityException requesting location updates", e)
close(e)
return@callbackFlow
}
awaitClose {
fusedClient.removeLocationUpdates(callback)
}
} else {
// Fallback: LocationManager for devices without Play Services
val locationManager = context.getSystemService(Context.LOCATION_SERVICE)
as? LocationManager
if (locationManager == null) {
close(IllegalStateException("LocationManager not available"))
return@callbackFlow
}
// Emit best last known location immediately (pick most recent of GPS/Network)
try {
val lastGps = locationManager.getLastKnownLocation(LocationManager.GPS_PROVIDER)
val lastNetwork = locationManager.getLastKnownLocation(LocationManager.NETWORK_PROVIDER)
val best = listOfNotNull(lastGps, lastNetwork).maxByOrNull { it.time }
if (best != null) {
val result = trySend(best)
if (result.isFailure) {
Log.w(TAG, "Failed to emit last known location (fallback)")
}
}
} catch (e: SecurityException) {
Log.e(TAG, "SecurityException getting last known location (fallback)", e)
}
// LocationListener compatible with API 26-28 (onStatusChanged required before API 29)
val listener = object : LocationListener {
override fun onLocationChanged(location: Location) {
val sendResult = trySend(location)
if (sendResult.isFailure) {
Log.w(TAG, "Failed to emit location update (fallback)")
}
}
// Required for API 26-28 compatibility (deprecated from API 29+)
@Deprecated("Deprecated in API 29")
override fun onStatusChanged(provider: String?, status: Int, extras: Bundle?) {}
override fun onProviderEnabled(provider: String) {}
override fun onProviderDisabled(provider: String) {}
}
try {
// Request from both providers: GPS is accurate, Network gives faster first fix
if (locationManager.isProviderEnabled(LocationManager.GPS_PROVIDER)) {
locationManager.requestLocationUpdates(
LocationManager.GPS_PROVIDER,
UPDATE_INTERVAL_MS,
0f,
listener,
Looper.getMainLooper()
)
}
if (locationManager.isProviderEnabled(LocationManager.NETWORK_PROVIDER)) {
locationManager.requestLocationUpdates(
LocationManager.NETWORK_PROVIDER,
UPDATE_INTERVAL_MS,
0f,
listener,
Looper.getMainLooper()
)
}
} catch (e: SecurityException) {
Log.e(TAG, "SecurityException requesting location updates (fallback)", e)
close(e)
return@callbackFlow
}
awaitClose {
locationManager.removeUpdates(listener)
}
}
}
fun hasLocationPermission(): Boolean {
return ContextCompat.checkSelfPermission(
context, Manifest.permission.ACCESS_FINE_LOCATION
) == PackageManager.PERMISSION_GRANTED
}
private fun isPlayServicesAvailable(): Boolean {
return try {
val result = GoogleApiAvailability.getInstance()
.isGooglePlayServicesAvailable(context)
result == ConnectionResult.SUCCESS
} catch (e: Exception) {
// Play Services library might not even be resolvable on some ROMs
false
}
}
}

View file

@ -0,0 +1,349 @@
package no.naiv.tilfluktsrom.widget
import android.Manifest
import android.app.PendingIntent
import android.appwidget.AppWidgetManager
import android.appwidget.AppWidgetProvider
import android.content.ComponentName
import android.content.Context
import android.content.Intent
import android.content.pm.PackageManager
import android.location.Location
import android.location.LocationManager
import android.os.Build
import android.os.CancellationSignal
import android.text.format.DateFormat
import android.util.Log
import android.widget.RemoteViews
import androidx.core.content.ContextCompat
import com.google.android.gms.common.ConnectionResult
import com.google.android.gms.common.GoogleApiAvailability
import com.google.android.gms.location.LocationServices
import com.google.android.gms.location.Priority
import com.google.android.gms.tasks.Tasks
import no.naiv.tilfluktsrom.MainActivity
import no.naiv.tilfluktsrom.R
import no.naiv.tilfluktsrom.data.ShelterDatabase
import no.naiv.tilfluktsrom.location.ShelterFinder
import no.naiv.tilfluktsrom.util.DistanceUtils
import java.util.concurrent.TimeUnit
/**
* Home screen widget showing the nearest shelter with distance.
*
* Update strategy:
* - Background: WorkManager runs every 15 min while widget exists
* - Live: MainActivity sends ACTION_REFRESH on each GPS location update
* - Manual: user taps the refresh button on the widget
*
* Location resolution (in priority order):
* 1. Location provided via intent extras (from WorkManager or MainActivity)
* 2. FusedLocationProviderClient cache/active request (Play Services)
* 3. LocationManager cache/active request (AOSP fallback)
* 4. Last GPS fix saved to SharedPreferences by MainActivity
*
* Note: Background processes cannot reliably trigger GPS hardware on
* Android 8+. The SharedPreferences fallback ensures the widget works
* after app updates and reboots without opening the app first.
*/
class ShelterWidgetProvider : AppWidgetProvider() {
companion object {
private const val TAG = "ShelterWidget"
const val ACTION_REFRESH = "no.naiv.tilfluktsrom.widget.REFRESH"
private const val EXTRA_LATITUDE = "lat"
private const val EXTRA_LONGITUDE = "lon"
/** Trigger a widget refresh from anywhere (e.g. MainActivity on location update). */
fun requestUpdate(context: Context) {
val intent = Intent(context, ShelterWidgetProvider::class.java).apply {
action = ACTION_REFRESH
}
context.sendBroadcast(intent)
}
/** Trigger a widget refresh with a known location (from WidgetUpdateWorker). */
fun requestUpdateWithLocation(context: Context, latitude: Double, longitude: Double) {
val intent = Intent(context, ShelterWidgetProvider::class.java).apply {
action = ACTION_REFRESH
putExtra(EXTRA_LATITUDE, latitude)
putExtra(EXTRA_LONGITUDE, longitude)
}
context.sendBroadcast(intent)
}
}
override fun onEnabled(context: Context) {
super.onEnabled(context)
WidgetUpdateWorker.schedule(context)
}
override fun onDisabled(context: Context) {
super.onDisabled(context)
WidgetUpdateWorker.cancel(context)
}
override fun onUpdate(
context: Context,
appWidgetManager: AppWidgetManager,
appWidgetIds: IntArray
) {
WidgetUpdateWorker.schedule(context)
updateAllWidgetsAsync(context, null)
}
override fun onReceive(context: Context, intent: Intent) {
super.onReceive(context, intent)
if (intent.action == ACTION_REFRESH) {
val providedLocation = if (intent.hasExtra(EXTRA_LATITUDE)) {
Location("widget").apply {
latitude = intent.getDoubleExtra(EXTRA_LATITUDE, 0.0)
longitude = intent.getDoubleExtra(EXTRA_LONGITUDE, 0.0)
}
} else null
updateAllWidgetsAsync(context, providedLocation)
}
}
/**
* Run widget update on a background thread so we can call
* FusedLocationProviderClient.getLastLocation() synchronously.
* Uses goAsync() to keep the BroadcastReceiver alive until done.
*/
private fun updateAllWidgetsAsync(context: Context, providedLocation: Location?) {
val pendingResult = goAsync()
Thread {
try {
val appWidgetManager = AppWidgetManager.getInstance(context)
val widgetIds = appWidgetManager.getAppWidgetIds(
ComponentName(context, ShelterWidgetProvider::class.java)
)
val location = providedLocation ?: getBestLocation(context)
for (appWidgetId in widgetIds) {
updateWidget(context, appWidgetManager, appWidgetId, location)
}
} catch (e: Exception) {
Log.e(TAG, "Failed to update widgets", e)
} finally {
pendingResult.finish()
}
}.start()
}
private fun updateWidget(
context: Context,
appWidgetManager: AppWidgetManager,
appWidgetId: Int,
location: Location?
) {
val views = RemoteViews(context.packageName, R.layout.widget_nearest_shelter)
// Tapping widget body opens the app
val openAppIntent = Intent(context, MainActivity::class.java)
val openAppPending = PendingIntent.getActivity(
context, 0, openAppIntent, PendingIntent.FLAG_IMMUTABLE
)
views.setOnClickPendingIntent(R.id.widgetRoot, openAppPending)
// Refresh button sends our custom broadcast
val refreshIntent = Intent(context, ShelterWidgetProvider::class.java).apply {
action = ACTION_REFRESH
}
val refreshPending = PendingIntent.getBroadcast(
context, 0, refreshIntent, PendingIntent.FLAG_IMMUTABLE
)
views.setOnClickPendingIntent(R.id.widgetRefreshButton, refreshPending)
// Check permission
if (ContextCompat.checkSelfPermission(
context, Manifest.permission.ACCESS_FINE_LOCATION
) != PackageManager.PERMISSION_GRANTED
) {
showFallback(context, views, context.getString(R.string.widget_open_app))
appWidgetManager.updateAppWidget(appWidgetId, views)
return
}
if (location == null) {
showFallback(context, views, context.getString(R.string.widget_no_location))
appWidgetManager.updateAppWidget(appWidgetId, views)
return
}
// Query shelters from Room (fast: ~556 rows, <10ms)
val shelters = try {
val dao = ShelterDatabase.getInstance(context).shelterDao()
kotlinx.coroutines.runBlocking { dao.getAllSheltersList() }
} catch (e: Exception) {
Log.e(TAG, "Failed to query shelters", e)
emptyList()
}
if (shelters.isEmpty()) {
showFallback(context, views, context.getString(R.string.widget_no_data))
appWidgetManager.updateAppWidget(appWidgetId, views)
return
}
// Find nearest shelter
val nearest = ShelterFinder.findNearest(
shelters, location.latitude, location.longitude, 1
).firstOrNull()
if (nearest == null) {
showFallback(context, views, context.getString(R.string.widget_no_data))
appWidgetManager.updateAppWidget(appWidgetId, views)
return
}
// Show shelter info
views.setTextViewText(R.id.widgetAddress, nearest.shelter.adresse)
views.setTextViewText(
R.id.widgetDetails,
context.getString(R.string.shelter_capacity, nearest.shelter.plasser)
)
views.setTextViewText(
R.id.widgetDistance,
DistanceUtils.formatDistance(nearest.distanceMeters)
)
views.setTextViewText(R.id.widgetTimestamp, formatTimestamp(context))
appWidgetManager.updateAppWidget(appWidgetId, views)
}
/** Show a fallback message when location or data is unavailable. */
private fun showFallback(context: Context, views: RemoteViews, message: String) {
views.setTextViewText(R.id.widgetAddress, message)
views.setTextViewText(R.id.widgetDetails, "")
views.setTextViewText(R.id.widgetDistance, "")
views.setTextViewText(R.id.widgetTimestamp, formatTimestamp(context))
}
/** Format current time as "Updated HH:mm", respecting the user's 12/24h preference. */
private fun formatTimestamp(context: Context): String {
val format = DateFormat.getTimeFormat(context)
val timeStr = format.format(System.currentTimeMillis())
return context.getString(R.string.widget_updated_at, timeStr)
}
/**
* Get the best available location.
* Tries FusedLocationProviderClient first (Play Services, better cache),
* then LocationManager (AOSP), then last saved GPS fix from SharedPreferences.
* Safe to call from a background thread.
*/
private fun getBestLocation(context: Context): Location? {
if (ContextCompat.checkSelfPermission(
context, Manifest.permission.ACCESS_FINE_LOCATION
) != PackageManager.PERMISSION_GRANTED
) return null
// Try Play Services first — maintains a better location cache
val fusedLocation = getFusedLastLocation(context)
if (fusedLocation != null) return fusedLocation
// Fall back to LocationManager
val lmLocation = getLocationManagerLocation(context)
if (lmLocation != null) return lmLocation
// Fall back to last location saved by MainActivity
return getSavedLocation(context)
}
/** Read the last GPS fix persisted by MainActivity to SharedPreferences.
* Returns null if older than 24 hours to avoid retaining stale location data. */
private fun getSavedLocation(context: Context): Location? {
val prefs = context.getSharedPreferences("widget_prefs", Context.MODE_PRIVATE)
if (!prefs.contains("last_lat")) return null
val age = System.currentTimeMillis() - prefs.getLong("last_time", 0L)
if (age > 24 * 60 * 60 * 1000L) return null
return Location("saved").apply {
latitude = prefs.getFloat("last_lat", 0f).toDouble()
longitude = prefs.getFloat("last_lon", 0f).toDouble()
}
}
/**
* Get location via Play Services blocks, call from background thread.
* Tries cached location first, then actively requests a fix if cache is empty.
*/
private fun getFusedLastLocation(context: Context): Location? {
if (!isPlayServicesAvailable(context)) return null
return try {
val client = LocationServices.getFusedLocationProviderClient(context)
// Try cache first (instant)
val cached = Tasks.await(client.lastLocation, 3, TimeUnit.SECONDS)
if (cached != null) return cached
// Cache empty — actively request a fix (turns on GPS/network)
val task = client.getCurrentLocation(
Priority.PRIORITY_BALANCED_POWER_ACCURACY, null
)
Tasks.await(task, 10, TimeUnit.SECONDS)
} catch (e: Exception) {
Log.w(TAG, "FusedLocationProvider failed", e)
null
}
}
/**
* Get location via LocationManager (AOSP).
* Tries cache first, then actively requests a fix on API 30+.
* Blocks call from background thread.
*/
private fun getLocationManagerLocation(context: Context): Location? {
val locationManager = context.getSystemService(Context.LOCATION_SERVICE)
as? LocationManager ?: return null
// Try cache first
try {
val lastGps = locationManager.getLastKnownLocation(LocationManager.GPS_PROVIDER)
val lastNetwork = locationManager.getLastKnownLocation(LocationManager.NETWORK_PROVIDER)
val cached = listOfNotNull(lastGps, lastNetwork).maxByOrNull { it.time }
if (cached != null) return cached
} catch (e: SecurityException) {
Log.e(TAG, "SecurityException getting last known location", e)
return null
}
// Cache empty — actively request on API 30+
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
val provider = when {
locationManager.isProviderEnabled(LocationManager.NETWORK_PROVIDER) ->
LocationManager.NETWORK_PROVIDER
locationManager.isProviderEnabled(LocationManager.GPS_PROVIDER) ->
LocationManager.GPS_PROVIDER
else -> return null
}
try {
val latch = java.util.concurrent.CountDownLatch(1)
var result: Location? = null
val signal = CancellationSignal()
locationManager.getCurrentLocation(
provider, signal, context.mainExecutor
) { location ->
result = location
latch.countDown()
}
latch.await(10, TimeUnit.SECONDS)
signal.cancel()
return result
} catch (e: Exception) {
Log.e(TAG, "Active location request failed", e)
}
}
return null
}
private fun isPlayServicesAvailable(context: Context): Boolean {
return try {
val result = GoogleApiAvailability.getInstance()
.isGooglePlayServicesAvailable(context)
result == ConnectionResult.SUCCESS
} catch (e: Exception) {
false
}
}
}

View file

@ -0,0 +1,187 @@
package no.naiv.tilfluktsrom.widget
import android.Manifest
import android.content.Context
import android.content.pm.PackageManager
import android.location.Location
import android.location.LocationManager
import android.os.Build
import android.os.CancellationSignal
import android.util.Log
import androidx.core.content.ContextCompat
import androidx.work.CoroutineWorker
import androidx.work.ExistingPeriodicWorkPolicy
import androidx.work.OneTimeWorkRequestBuilder
import androidx.work.PeriodicWorkRequestBuilder
import androidx.work.WorkManager
import androidx.work.WorkerParameters
import com.google.android.gms.common.ConnectionResult
import com.google.android.gms.common.GoogleApiAvailability
import com.google.android.gms.location.LocationServices
import com.google.android.gms.location.Priority
import com.google.android.gms.tasks.Tasks
import kotlinx.coroutines.suspendCancellableCoroutine
import kotlinx.coroutines.withTimeoutOrNull
import java.util.concurrent.TimeUnit
import kotlin.coroutines.resume
/**
* Periodic background worker that refreshes the home screen widget.
*
* Scheduled every 15 minutes (WorkManager's minimum interval).
* Actively requests a fresh location fix to populate the system cache,
* then triggers the widget's existing update logic via broadcast.
*
* Location strategy (mirrors LocationProvider):
* - Play Services: FusedLocationProviderClient.getCurrentLocation()
* - AOSP API 30+: LocationManager.getCurrentLocation()
* - AOSP API 26-29: LocationManager.getLastKnownLocation()
*/
class WidgetUpdateWorker(
context: Context,
params: WorkerParameters
) : CoroutineWorker(context, params) {
companion object {
private const val TAG = "WidgetUpdateWorker"
private const val WORK_NAME = "widget_update"
private const val LOCATION_TIMEOUT_MS = 10_000L
/** Schedule periodic widget updates. Safe to call multiple times. */
fun schedule(context: Context) {
val request = PeriodicWorkRequestBuilder<WidgetUpdateWorker>(
15, TimeUnit.MINUTES
).build()
WorkManager.getInstance(context).enqueueUniquePeriodicWork(
WORK_NAME,
ExistingPeriodicWorkPolicy.KEEP,
request
)
}
/** Run once immediately (e.g. when widget is first placed or location was unavailable). */
fun runOnce(context: Context) {
val request = OneTimeWorkRequestBuilder<WidgetUpdateWorker>().build()
WorkManager.getInstance(context).enqueue(request)
}
/** Cancel periodic updates (e.g. when all widgets are removed). */
fun cancel(context: Context) {
WorkManager.getInstance(context).cancelUniqueWork(WORK_NAME)
}
}
override suspend fun doWork(): Result {
val location = requestFreshLocation() ?: getSavedLocation()
if (location != null) {
ShelterWidgetProvider.requestUpdateWithLocation(
applicationContext, location.latitude, location.longitude
)
} else {
ShelterWidgetProvider.requestUpdate(applicationContext)
}
return Result.success()
}
/** Read the last GPS fix persisted by MainActivity.
* Returns null if older than 24 hours. */
private fun getSavedLocation(): Location? {
val prefs = applicationContext.getSharedPreferences("widget_prefs", Context.MODE_PRIVATE)
if (!prefs.contains("last_lat")) return null
val age = System.currentTimeMillis() - prefs.getLong("last_time", 0L)
if (age > 24 * 60 * 60 * 1000L) return null
return Location("saved").apply {
latitude = prefs.getFloat("last_lat", 0f).toDouble()
longitude = prefs.getFloat("last_lon", 0f).toDouble()
}
}
/**
* Actively request a location fix and return it.
* Returns null if permission is missing or location is unavailable.
*/
private suspend fun requestFreshLocation(): Location? {
val context = applicationContext
if (ContextCompat.checkSelfPermission(context, Manifest.permission.ACCESS_FINE_LOCATION)
!= PackageManager.PERMISSION_GRANTED
) return null
return if (isPlayServicesAvailable()) {
requestViaPlayServices()
} else {
requestViaLocationManager()
}
}
/** Use FusedLocationProviderClient.getCurrentLocation() — best accuracy, best cache. */
private suspend fun requestViaPlayServices(): Location? {
return try {
val client = LocationServices.getFusedLocationProviderClient(applicationContext)
val task = client.getCurrentLocation(Priority.PRIORITY_BALANCED_POWER_ACCURACY, null)
Tasks.await(task, LOCATION_TIMEOUT_MS, TimeUnit.MILLISECONDS)
} catch (e: SecurityException) {
Log.e(TAG, "SecurityException requesting location via Play Services", e)
null
} catch (e: Exception) {
Log.w(TAG, "Play Services location request failed, falling back", e)
requestViaLocationManager()
}
}
/** Use LocationManager.getCurrentLocation() (API 30+) or getLastKnownLocation() fallback. */
private suspend fun requestViaLocationManager(): Location? {
val locationManager = applicationContext.getSystemService(Context.LOCATION_SERVICE)
as? LocationManager ?: return null
val provider = when {
locationManager.isProviderEnabled(LocationManager.GPS_PROVIDER) ->
LocationManager.GPS_PROVIDER
locationManager.isProviderEnabled(LocationManager.NETWORK_PROVIDER) ->
LocationManager.NETWORK_PROVIDER
else -> return null
}
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
return requestCurrentLocation(locationManager, provider)
}
// API 26-29: fall back to passive cache
return try {
locationManager.getLastKnownLocation(provider)
} catch (e: SecurityException) {
null
}
}
/** API 30+: actively request a single location fix. */
private suspend fun requestCurrentLocation(locationManager: LocationManager, provider: String): Location? {
return try {
withTimeoutOrNull(LOCATION_TIMEOUT_MS) {
suspendCancellableCoroutine<Location?> { cont ->
val signal = CancellationSignal()
locationManager.getCurrentLocation(
provider,
signal,
applicationContext.mainExecutor
) { location ->
if (cont.isActive) cont.resume(location)
}
cont.invokeOnCancellation { signal.cancel() }
}
}
} catch (e: SecurityException) {
Log.e(TAG, "SecurityException requesting location via LocationManager", e)
null
}
}
private fun isPlayServicesAvailable(): Boolean {
return try {
val result = GoogleApiAvailability.getInstance()
.isGooglePlayServicesAvailable(applicationContext)
result == ConnectionResult.SUCCESS
} catch (e: Exception) {
false
}
}
}

View file

@ -0,0 +1,4 @@
• Hybrid location: uses Play Services when available, falls back to standard Android GPS
• Data freshness indicator shows when shelter data was last updated
• Home screen widget showing nearest shelter with distance
• Bundled shelter data for instant offline use on first launch

View file

@ -0,0 +1,3 @@
• Share shelter location with others via any app
• Deep link support — open shared shelters directly in the app
• Tap any marker on the map to select and navigate to it

View file

@ -0,0 +1,2 @@
• Widget now updates automatically every 15 minutes via WorkManager
• Fixed widget not showing data without opening the app first

View file

@ -0,0 +1,4 @@
• Civil defense information: what to do if the alarm sounds (based on DSB guidelines)
• Improved accessibility: screen reader labels, better contrast, haptic feedback
• Widget shows "Updated 14:32" instead of bare timestamp
• Copyright notice added

View file

@ -0,0 +1,6 @@
• Accessibility: screen reader labels on shelter list, compass, and direction arrows
• Improved contrast on status bar text (WCAG AA)
• Haptic feedback on all buttons and list items
• Widget timestamp now shows "Updated 14:32"
• Softer civil defense dialog title
• Copyright notice added

View file

@ -0,0 +1,2 @@
- Show waiting status when GPS is unavailable instead of empty shelter list
- Add F-Droid screenshots for all locales

View file

@ -0,0 +1,2 @@
- Add F-Droid build flavor without Google Play Services
- Move signing config out of source code

View file

@ -0,0 +1,15 @@
Find the nearest public emergency shelter (tilfluktsrom) in Norway. Built for emergencies — works fully offline after first use.
Features:
• Shows the 3 nearest shelters with distance and capacity
• Compass navigation — direction arrow points to the selected shelter
• Offline map — map tiles are cached automatically for use without internet
• Select any shelter — tap any marker on the map to navigate there
• Home screen widget — shows nearest shelter at a glance
• Share shelters — send shelter location to others via any app
• Civil defense info — what to do if the alarm sounds
• Multilingual — English, Bokmål, and Nynorsk
The app uses open data from Geonorge (Norwegian Mapping Authority) covering approximately 556 public shelters across Norway.
Works on degoogled devices: the app uses Google Play Services for better location accuracy when available, but falls back to standard Android location APIs on devices without Play Services (LineageOS, GrapheneOS, /e/OS, etc.).

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.4 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.2 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 160 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 394 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 360 KiB

View file

@ -0,0 +1 @@
Find the nearest public emergency shelter in Norway — works offline

View file

@ -0,0 +1 @@
Tilfluktsrom

View file

@ -0,0 +1,4 @@
• Hybrid posisjon: bruker Play Services når tilgjengelig, faller tilbake til standard Android-GPS
• Dataferskhetsindikator viser når tilfluktsromdata sist ble oppdatert
• Hjemskjerm-widget som viser nærmeste tilfluktsrom med avstand
• Medfølgende tilfluktsromdata for umiddelbar frakoblet bruk ved første oppstart

View file

@ -0,0 +1,3 @@
• Del tilfluktsrom med andre via en hvilken som helst app
• Støtte for dyplenker — åpne delte tilfluktsrom direkte i appen
• Trykk på en markør i kartet for å velge og navigere dit

View file

@ -0,0 +1,2 @@
• Widget oppdateres nå automatisk hvert 15. minutt via WorkManager
• Fikset at widget ikke viste data uten å åpne appen først

View file

@ -0,0 +1,4 @@
• Sivilforsvarsinformasjon: hva du skal gjøre hvis alarmen går (basert på DSB-retningslinjer)
• Forbedret tilgjengelighet: skjermleseretiketter, bedre kontrast, haptisk tilbakemelding
• Widget viser «Oppdatert 14:32» i stedet for bare tidsstempel
• Opphavsrettsmelding lagt til

View file

@ -0,0 +1,6 @@
• Tilgjengelighet: skjermleseretiketter på tilfluktsromliste, kompass og retningspil
• Forbedret kontrast på statuslinjetekst (WCAG AA)
• Haptisk tilbakemelding på alle knapper og listeelement
• Widget-tidsstempel viser nå «Oppdatert 14:32»
• Mildere tittel på sivilforsvarsdialog
• Opphavsrettsmelding lagt til

View file

@ -0,0 +1,2 @@
- Vis ventestatus når GPS ikke er tilgjengelig i stedet for tom tilfluktsromliste
- Legg til F-Droid-skjermbilder for alle språk

View file

@ -0,0 +1,2 @@
- Legg til F-Droid-byggvariant uten Google Play Services
- Flytt signeringskonfigurasjon ut av kildekoden

View file

@ -0,0 +1,15 @@
Finn nærmeste offentlige tilfluktsrom i Norge. Bygd for nødsituasjoner — fungerer helt uten internett etter første gangs bruk.
Funksjoner:
• Viser de 3 nærmeste tilfluktsrommene med avstand og kapasitet
• Kompassnavigasjon — retningspil som peker mot valgt tilfluktsrom
• Frakoblet kart — kartfliser lagres automatisk for bruk uten nett
• Velg fritt — trykk på en markør i kartet for å navigere dit
• Hjemskjerm-widget — viser nærmeste tilfluktsrom med ett blikk
• Del tilfluktsrom — send posisjon til andre via en hvilken som helst app
• Sivilforsvarsinformasjon — hva du skal gjøre hvis alarmen går
• Flerspråklig — engelsk, bokmål og nynorsk
Appen bruker åpne data fra Geonorge (Kartverket) med ca. 556 offentlige tilfluktsrom i hele Norge.
Fungerer på de-Google-enheter: appen bruker Google Play Services for bedre posisjonsdata når det er tilgjengelig, men faller tilbake til standard Android-posisjons-API-er på enheter uten Play Services (LineageOS, GrapheneOS, /e/OS osv.).

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.4 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.2 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 160 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 394 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 360 KiB

View file

@ -0,0 +1 @@
Finn nærmeste offentlige tilfluktsrom i Norge — fungerer uten nett

View file

@ -0,0 +1 @@
Tilfluktsrom

View file

@ -0,0 +1,4 @@
• Hybrid posisjon: brukar Play Services når tilgjengeleg, fell tilbake til standard Android-GPS
• Dataferskheitsindikator viser når tilfluktsromdata sist vart oppdatert
• Heimeskjerm-widget som viser næraste tilfluktsrom med avstand
• Medfølgjande tilfluktsromdata for umiddelbar fråkopla bruk ved fyrste oppstart

View file

@ -0,0 +1,3 @@
• Del tilfluktsrom med andre via ei kva som helst app
• Støtte for djuplenker — opne delte tilfluktsrom direkte i appen
• Trykk på ein markør i kartet for å velje og navigere dit

View file

@ -0,0 +1,2 @@
• Widget oppdaterast no automatisk kvart 15. minutt via WorkManager
• Fiksa at widget ikkje viste data utan å opne appen fyrst

View file

@ -0,0 +1,4 @@
• Sivilforsvarsinformasjon: kva du skal gjere om alarmen går (basert på DSB-retningslinjer)
• Forbetra tilgjenge: skjermlesar-etiketter, betre kontrast, haptisk tilbakemelding
• Widget viser «Oppdatert 14:32» i staden for berre tidsstempel
• Opphavsrettsmelding lagt til

View file

@ -0,0 +1,6 @@
• Tilgjenge: skjermlesar-etiketter på tilfluktsromliste, kompass og retningspil
• Forbetra kontrast på statuslinjetekst (WCAG AA)
• Haptisk tilbakemelding på alle knappar og listeelement
• Widget-tidsstempel viser no «Oppdatert 14:32»
• Mildare tittel på sivilforsvarsdialog
• Opphavsrettsmelding lagt til

View file

@ -0,0 +1,2 @@
- Vis ventestatus når GPS ikkje er tilgjengeleg i staden for tom tilfluktsromliste
- Legg til F-Droid-skjermbilete for alle språk

View file

@ -0,0 +1,2 @@
- Legg til F-Droid-byggvariant utan Google Play Services
- Flytt signeringskonfigurasjon ut av kjeldekoden

View file

@ -0,0 +1,15 @@
Finn næraste offentlege tilfluktsrom i Noreg. Bygd for nødsituasjonar — fungerer heilt utan internett etter fyrste gongs bruk.
Funksjonar:
• Viser dei 3 næraste tilfluktsromma med avstand og kapasitet
• Kompassnavigasjon — retningspil som peikar mot valt tilfluktsrom
• Fråkopla kart — kartfliser lagrast automatisk for bruk utan nett
• Vel fritt — trykk på ein markør i kartet for å navigere dit
• Heimeskjerm-widget — viser næraste tilfluktsrom med eitt blikk
• Del tilfluktsrom — send posisjon til andre via ei kva som helst app
• Sivilforsvarsinformasjon — kva du skal gjere om alarmen går
• Fleirspråkleg — engelsk, bokmål og nynorsk
Appen brukar opne data frå Geonorge (Kartverket) med ca. 556 offentlege tilfluktsrom i heile Noreg.
Fungerer på de-Google-einingar: appen brukar Google Play Services for betre posisjonsdata når det er tilgjengeleg, men fell tilbake til standard Android-posisjons-API-ar på einingar utan Play Services (LineageOS, GrapheneOS, /e/OS osb.).

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.4 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.2 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 160 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 394 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 360 KiB

View file

@ -0,0 +1 @@
Finn næraste offentlege tilfluktsrom i Noreg — fungerer utan nett

View file

@ -0,0 +1 @@
Tilfluktsrom

1
pwa/.gitignore vendored
View file

@ -1,2 +1,3 @@
node_modules/
dist/
public/data/shelters.json

View file

@ -1,68 +1,68 @@
<!DOCTYPE html>
<html lang="en">
<html lang="en" dir="ltr">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no" />
<meta name="theme-color" content="#1A1A2E" />
<meta name="description" content="Find the nearest public shelter in Norway" />
<meta http-equiv="Content-Security-Policy"
content="default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data: https://*.tile.openstreetmap.org; connect-src 'self' https://*.tile.openstreetmap.org; font-src 'self'; worker-src 'self'" />
<title>Tilfluktsrom</title>
<link rel="manifest" href="/manifest.webmanifest" />
<link rel="icon" type="image/png" sizes="192x192" href="/icons/icon-192.png" />
<link rel="apple-touch-icon" href="/icons/icon-192.png" />
<link rel="stylesheet" href="https://unpkg.com/leaflet@1.9.4/dist/leaflet.css"
integrity="sha256-p4NxAoJBhIIN+hmNHrzRCf9tD/miZyoHS5obTRR9BMY="
crossorigin="" />
<link rel="manifest" href="manifest.webmanifest" />
<link rel="icon" type="image/png" sizes="192x192" href="icons/icon-192.png" />
<link rel="apple-touch-icon" href="icons/icon-192.png" />
</head>
<body>
<div id="app">
<!-- Status bar -->
<div id="status-bar">
<span id="status-text"></span>
<header id="status-bar" role="banner">
<span id="status-text" aria-live="polite"></span>
<button id="about-btn" aria-label="About">&#x2139;</button>
<button id="refresh-btn" aria-label="Refresh data">&#x21bb;</button>
</div>
</header>
<!-- Main content: map or compass -->
<div id="main-content">
<div id="map-container"></div>
<div id="compass-container">
<main id="main-content">
<div id="map-container" role="application" aria-label="Map"></div>
<div id="compass-container" role="img" aria-label="Compass">
<span id="compass-address"></span>
<span id="compass-distance"></span>
<span id="compass-distance" aria-live="polite"></span>
</div>
<!-- Toggle map/compass FAB -->
<button id="toggle-fab" aria-label="Toggle map/compass view">&#x1F9ED;</button>
<!-- Reset view button -->
<button id="reset-view-btn" aria-label="Reset view">&#x2316;</button>
</div>
</main>
<!-- No-cache warning banner -->
<div id="no-cache-banner">
<div id="no-cache-banner" role="alert">
<span id="no-cache-text"></span>
<button id="cache-retry-btn"></button>
</div>
<!-- Bottom sheet with shelter info -->
<div id="bottom-sheet">
<div id="selected-shelter">
<canvas id="mini-arrow" width="96" height="96"></canvas>
<aside id="bottom-sheet" aria-label="Shelter info">
<div id="selected-shelter" aria-live="polite">
<canvas id="mini-arrow" width="96" height="96" role="img" aria-label="Direction to shelter"></canvas>
<div id="selected-shelter-info">
<div id="selected-shelter-address"></div>
<div id="selected-shelter-details"></div>
</div>
</div>
<div id="shelter-list"></div>
</div>
<div id="shelter-list" role="list" aria-label="Nearest shelters"></div>
</aside>
</div>
<!-- Loading overlay -->
<div id="loading-overlay">
<div id="loading-spinner"></div>
<div id="loading-text"></div>
<div id="loading-overlay" role="dialog" aria-modal="true" aria-label="Loading">
<div id="loading-spinner" aria-hidden="true"></div>
<div id="loading-text" aria-live="assertive" tabindex="-1"></div>
<div id="loading-button-row">
<button id="loading-skip-btn"></button>
<button id="loading-ok-btn"></button>
</div>
</div>
<script type="module" src="/src/main.ts"></script>
<script type="module" src="src/main.ts"></script>
</body>
</html>

View file

@ -0,0 +1,12 @@
[
{
"relation": ["delegate_permission/common.handle_all_urls"],
"target": {
"namespace": "android_app",
"package_name": "no.naiv.tilfluktsrom",
"sha256_cert_fingerprints": [
"43:05:79:6F:EA:3E:F4:50:45:D3:8A:EF:EA:58:B6:65:49:D2:D2:C3:4B:4C:61:11:EE:74:48:B0:C7:70:E4:5B"
]
}
}
]

File diff suppressed because it is too large Load diff

View file

@ -2,20 +2,21 @@
"name": "Tilfluktsrom",
"short_name": "Tilfluktsrom",
"description": "Find the nearest public shelter in Norway",
"start_url": "/",
"start_url": ".",
"scope": ".",
"display": "standalone",
"orientation": "portrait",
"theme_color": "#1A1A2E",
"background_color": "#1A1A2E",
"icons": [
{
"src": "/icons/icon-192.png",
"src": "icons/icon-192.png",
"sizes": "192x192",
"type": "image/png",
"purpose": "any maskable"
},
{
"src": "/icons/icon-512.png",
"src": "icons/icon-512.png",
"sizes": "512x512",
"type": "image/png",
"purpose": "any maskable"

View file

@ -9,7 +9,7 @@
import type { Shelter, ShelterWithDistance, LatLon } from './types';
import { t } from './i18n/i18n';
import { formatDistance } from './util/distance-utils';
import { formatDistance, distanceMeters, bearingDegrees } from './util/distance-utils';
import { findNearest } from './location/shelter-finder';
import * as repo from './data/shelter-repository';
import * as locationProvider from './location/location-provider';
@ -20,6 +20,7 @@ import * as shelterList from './ui/shelter-list';
import * as statusBar from './ui/status-bar';
import * as loading from './ui/loading-overlay';
import * as mapCache from './cache/map-cache-manager';
import * as civilDefenseDialog from './ui/civil-defense-dialog';
const NEAREST_COUNT = 3;
@ -36,11 +37,28 @@ let firstLocationFix = true;
let userSelectedShelter = false;
export async function init(): Promise<void> {
applyA11yLabels();
setupMap();
setupCompass();
setupShelterList();
setupButtons();
await loadData();
handleDeepLink();
}
/** Set localized aria-labels and wire the about button. */
function applyA11yLabels(): void {
document.getElementById('about-btn')?.setAttribute('aria-label', t('action_civil_defense_info'));
document.getElementById('about-btn')?.addEventListener('click', () => {
navigator.vibrate?.(10);
civilDefenseDialog.showCivilDefenseInfo();
});
document.getElementById('map-container')?.setAttribute('aria-label', t('a11y_map'));
document.getElementById('compass-container')?.setAttribute('aria-label', t('a11y_compass'));
document.getElementById('bottom-sheet')?.setAttribute('aria-label', t('a11y_shelter_info'));
document.getElementById('shelter-list')?.setAttribute('aria-label', t('a11y_nearest_shelters'));
document.getElementById('refresh-btn')?.setAttribute('aria-label', t('action_refresh'));
document.getElementById('toggle-fab')?.setAttribute('aria-label', t('action_toggle_view'));
}
function setupMap(): void {
@ -76,6 +94,7 @@ function setupButtons(): void {
// Toggle map/compass
const toggleFab = document.getElementById('toggle-fab')!;
toggleFab.addEventListener('click', async () => {
navigator.vibrate?.(10);
isCompassMode = !isCompassMode;
const mapContainer = document.getElementById('map-container')!;
@ -90,6 +109,7 @@ function setupButtons(): void {
}
mapContainer.style.display = 'none';
compassContainer.classList.add('active');
compassView.resize();
toggleFab.textContent = '\uD83D\uDDFA\uFE0F'; // map emoji
compassProvider.startCompass(onHeadingUpdate);
} else {
@ -112,6 +132,7 @@ function setupButtons(): void {
const cacheRetryBtn = document.getElementById('cache-retry-btn')!;
cacheRetryBtn.textContent = t('action_cache_now');
cacheRetryBtn.addEventListener('click', () => {
navigator.vibrate?.(10);
if (currentLocation && navigator.onLine) {
startCaching(currentLocation.latitude, currentLocation.longitude);
}
@ -120,6 +141,7 @@ function setupButtons(): void {
// Reset view button
const resetBtn = document.getElementById('reset-view-btn')!;
resetBtn.addEventListener('click', () => {
navigator.vibrate?.(10);
const selected = nearestShelters[selectedShelterIndex] ?? null;
mapView.resetView(selected, currentLocation);
resetBtn.classList.remove('visible');
@ -256,6 +278,8 @@ function updateSelectedShelter(isUserAction: boolean): void {
].join(' \u00B7 ');
// Update mini arrow
const miniArrow = document.getElementById('mini-arrow')!;
miniArrow.setAttribute('aria-label', t('direction_arrow_description', dist));
updateMiniArrow(selected.bearingDegrees - deviceHeading);
// Update compass view
@ -263,6 +287,7 @@ function updateSelectedShelter(isUserAction: boolean): void {
document.getElementById('compass-address')!.textContent =
selected.shelter.adresse;
compassView.setDirection(selected.bearingDegrees - deviceHeading);
compassView.setNorthAngle(-deviceHeading);
// Update shelter list selection
shelterList.updateList(nearestShelters, selectedShelterIndex);
@ -285,6 +310,7 @@ function onHeadingUpdate(heading: number): void {
const angle = selected.bearingDegrees - heading;
compassView.setDirection(angle);
compassView.setNorthAngle(-heading);
updateMiniArrow(angle);
}
@ -373,3 +399,67 @@ async function forceRefresh(): Promise<void> {
statusBar.setStatus(t('update_failed'));
}
}
/**
* Handle /shelter/{lokalId} deep links.
* Called after loadData() so allShelters is populated.
*/
function handleDeepLink(): void {
const match = window.location.pathname.match(/^\/shelter\/(.+)$/);
if (!match) return;
const lokalId = decodeURIComponent(match[1]);
// Clean the URL so refresh doesn't re-trigger
window.history.replaceState({}, '', '/');
const shelter = allShelters.find((s) => s.lokalId === lokalId);
if (!shelter) {
statusBar.setStatus(t('error_shelter_not_found'));
return;
}
selectShelterByData(shelter);
}
/**
* Select a specific shelter, even if it's not in the current nearest-3 list.
* Used for deep link targets.
*/
function selectShelterByData(shelter: Shelter): void {
// Check if it's already in nearestShelters
const existingIdx = nearestShelters.findIndex(
(s) => s.shelter.lokalId === shelter.lokalId,
);
if (existingIdx >= 0) {
userSelectedShelter = true;
selectedShelterIndex = existingIdx;
} else {
// Compute distance/bearing if we have a location, otherwise use placeholder
let dist = NaN;
let bearing = 0;
if (currentLocation) {
dist = distanceMeters(
currentLocation.latitude, currentLocation.longitude,
shelter.latitude, shelter.longitude,
);
bearing = bearingDegrees(
currentLocation.latitude, currentLocation.longitude,
shelter.latitude, shelter.longitude,
);
}
// Prepend to the list so it becomes the selected shelter
nearestShelters.unshift({
shelter,
distanceMeters: dist,
bearingDegrees: bearing,
});
userSelectedShelter = true;
selectedShelterIndex = 0;
shelterList.updateList(nearestShelters, selectedShelterIndex);
}
updateSelectedShelter(true);
}

View file

@ -94,9 +94,10 @@ export async function cacheMapArea(
// Restore original view
map.setView(originalCenter, originalZoom, { animate: false });
// Round coordinates to 1 decimal (~11km) to limit location precision in storage
saveCacheMeta({
lat,
lon,
lat: Math.round(lat * 10) / 10,
lon: Math.round(lon * 10) / 10,
radius: CACHE_RADIUS_DEGREES,
complete: true,
});

2
pwa/src/config.ts Normal file
View file

@ -0,0 +1,2 @@
/** Deep link domain — single source of truth for the PWA. */
export const DEEP_LINK_DOMAIN = 'tilfluktsrom.naiv.no';

View file

@ -46,4 +46,47 @@ export const en: Record<string, string> = {
'No cached data available. Connect to the internet to download shelter data.',
update_success: 'Shelter data updated',
update_failed: 'Update failed \u2014 using cached data',
error_shelter_not_found: 'Shelter not found',
// Accessibility
direction_arrow_description: 'Direction to shelter, %s away',
a11y_map: 'Map',
a11y_compass: 'Compass',
a11y_shelter_info: 'Shelter info',
a11y_nearest_shelters: 'Nearest shelters',
// Civil defense
action_civil_defense_info: 'Civil defense information',
civil_defense_title: 'What to do if the alarm sounds',
civil_defense_step1_title: '1. Important message signal',
civil_defense_step1_body: 'Three series of short blasts with one minute of silence between each series. This means: seek information immediately. Turn on DAB radio, TV, or check official sources online.',
civil_defense_step2_title: '2. Air raid alarm',
civil_defense_step2_body: 'Short blasts lasting approximately one minute. This means immediate danger of attack — seek shelter now. Go to the nearest shelter, basement, or inner room immediately.',
civil_defense_step3_title: '3. Go indoors and find shelter',
civil_defense_step3_body: 'Get indoors. Close all windows, doors, and ventilation openings. Use this app to find the nearest public shelter. The compass and map work offline. If no shelter is nearby, go to a basement or an inner room away from windows.',
civil_defense_step4_title: '4. Listen to NRK on DAB radio',
civil_defense_step4_body: 'Tune in to NRK P1 on DAB radio for official updates and instructions from authorities. DAB radio works even when mobile networks and the internet are down.',
civil_defense_step5_title: '5. All clear',
civil_defense_step5_body: 'One continuous tone lasting approximately 30 seconds. The danger or attack is over. Continue to follow instructions from authorities.',
civil_defense_source: 'Source: DSB (Norwegian Directorate for Civil Protection)',
// About
about_title: 'About Tilfluktsrom',
about_description:
'Tilfluktsrom helps you find the nearest public shelter in Norway. The app works offline after initial setup.',
about_privacy_title: 'Privacy',
about_privacy_body:
'This app does not collect, transmit, or share any personal data. There are no analytics, tracking, or third-party services. Your GPS location is used only on your device to find nearby shelters and is never sent to any server.',
about_data_title: 'Data sources',
about_data_body:
'Shelter data: DSB (Norwegian Directorate for Civil Protection), distributed via Geonorge. Map tiles: OpenStreetMap. Both are cached locally for offline use.',
about_stored_title: 'Stored on your device',
about_stored_body:
'Shelter database (public data), map tiles for offline use, and map cache metadata. No data leaves your device except requests to download shelter data and map tiles.',
about_copyright: 'Copyright © Ole-Morten Duesund',
about_open_source: 'Open source — kode.naiv.no/olemd/tilfluktsrom',
action_about: 'About',
action_close: 'Close',
action_clear_cache: 'Clear cached data',
cache_cleared: 'All cached data cleared',
};

View file

@ -11,21 +11,22 @@ const locales: Record<string, Record<string, string>> = { en, nb, nn };
let currentLocale = 'en';
/** Detect and set locale from browser preferences. */
/** Detect and set locale from browser preferences, update document lang. */
export function initLocale(): void {
const langs = navigator.languages ?? [navigator.language];
for (const lang of langs) {
const code = lang.toLowerCase().split('-')[0];
if (code in locales) {
currentLocale = code;
return;
break;
}
// nb and nn both start with "n" — also match "no" as Bokmål
if (code === 'no') {
currentLocale = 'nb';
return;
break;
}
}
document.documentElement.lang = currentLocale;
}
/** Get current locale code. */

View file

@ -1,4 +1,4 @@
/** Norwegian Bokm\u00e5l strings. Ported from res/values-nb/strings.xml. */
/** Norwegian Bokmål strings. Ported from res/values-nb/strings.xml. */
export const nb: Record<string, string> = {
app_name: 'Tilfluktsrom',
@ -7,38 +7,81 @@ export const nb: Record<string, string> = {
status_updating: 'Oppdaterer\u2026',
status_offline: 'Frakoblet modus',
status_shelters_loaded: '%d tilfluktsrom lastet',
status_no_location: 'Venter p\u00e5 GPS\u2026',
status_no_location: 'Venter på GPS\u2026',
status_caching_map: 'Lagrer kart for frakoblet bruk\u2026',
loading_shelters: 'Laster ned tilfluktsromdata\u2026',
loading_map: 'Lagrer kartfliser\u2026',
loading_map_explanation:
'Forbereder frakoblet kart.\nKartet vil rulle kort for \u00e5 lagre omgivelsene dine.',
loading_first_time: 'Gj\u00f8r klar for f\u00f8rste gangs bruk\u2026',
'Forbereder frakoblet kart.\nKartet vil rulle kort for å lagre omgivelsene dine.',
loading_first_time: 'Gjør klar for første gangs bruk\u2026',
shelter_capacity: '%d plasser',
shelter_room_nr: 'Rom %d',
nearest_shelter: 'N\u00e6rmeste tilfluktsrom',
nearest_shelter: 'Nærmeste tilfluktsrom',
no_shelters: 'Ingen tilfluktsromdata tilgjengelig',
action_refresh: 'Oppdater data',
action_toggle_view: 'Bytt mellom kart og kompassvisning',
action_skip: 'Hopp over',
action_cache_ok: 'Lagre kart',
action_cache_now: 'Lagre n\u00e5',
action_cache_now: 'Lagre nå',
warning_no_map_cache:
'Ingen frakoblet kart lagret. Kartet krever internett.',
permission_location_title: 'Posisjonstillatelse kreves',
permission_location_message:
'Denne appen trenger din posisjon for \u00e5 finne n\u00e6rmeste tilfluktsrom. Vennligst gi tilgang til posisjon.',
'Denne appen trenger din posisjon for å finne nærmeste tilfluktsrom. Vennligst gi tilgang til posisjon.',
permission_denied:
'Posisjonstillatelse avsl\u00e5tt. Appen kan ikke finne tilfluktsrom i n\u00e6rheten uten den.',
'Posisjonstillatelse avslått. Appen kan ikke finne tilfluktsrom i nærheten uten den.',
error_download_failed:
'Kunne ikke laste ned tilfluktsromdata. Sjekk internettforbindelsen.',
error_no_data_offline:
'Ingen lagrede data tilgjengelig. Koble til internett for \u00e5 laste ned tilfluktsromdata.',
'Ingen lagrede data tilgjengelig. Koble til internett for å laste ned tilfluktsromdata.',
update_success: 'Tilfluktsromdata oppdatert',
update_failed: 'Oppdatering mislyktes \u2014 bruker lagrede data',
update_failed: 'Oppdatering mislyktes — bruker lagrede data',
error_shelter_not_found: 'Fant ikke tilfluktsrommet',
// Tilgjengelighet
direction_arrow_description: 'Retning til tilfluktsrom, %s unna',
a11y_map: 'Kart',
a11y_compass: 'Kompass',
a11y_shelter_info: 'Tilfluktsrominfo',
a11y_nearest_shelters: 'Nærmeste tilfluktsrom',
// Sivilforsvar
action_civil_defense_info: 'Sivilforsvarsinformasjon',
civil_defense_title: 'Hva du skal gjøre hvis alarmen går',
civil_defense_step1_title: '1. Viktig melding-signalet',
civil_defense_step1_body: 'Tre serier med korte støt med ett minutts stillhet mellom hver serie. Dette betyr: søk informasjon umiddelbart. Slå på DAB-radio, TV, eller sjekk offisielle kilder på nett.',
civil_defense_step2_title: '2. Flyalarm',
civil_defense_step2_body: 'Korte støt som varer omtrent ett minutt. Dette betyr umiddelbar fare for angrep — søk dekning nå. Gå til nærmeste tilfluktsrom, kjeller eller innerrom umiddelbart.',
civil_defense_step3_title: '3. Gå innendørs og finn dekning',
civil_defense_step3_body: 'Kom deg innendørs. Lukk alle vinduer, dører og ventilasjonsåpninger. Bruk denne appen for å finne nærmeste offentlige tilfluktsrom. Kompasset og kartet fungerer uten internett. Hvis det ikke er noe tilfluktsrom i nærheten, gå til en kjeller eller et innerrom bort fra vinduer.',
civil_defense_step4_title: '4. Lytt til NRK på DAB-radio',
civil_defense_step4_body: 'Lytt til NRK P1 på DAB-radio for offisielle oppdateringer og instruksjoner fra myndighetene. DAB-radio fungerer selv når mobilnettet og internett er nede.',
civil_defense_step5_title: '5. Faren over',
civil_defense_step5_body: 'Én sammenhengende tone på omtrent 30 sekunder. Faren eller angrepet er over. Fortsett å følge instruksjoner fra myndighetene.',
civil_defense_source: 'Kilde: DSB (Direktoratet for samfunnssikkerhet og beredskap)',
// Om
about_title: 'Om Tilfluktsrom',
about_description:
'Tilfluktsrom hjelper deg med å finne nærmeste offentlige tilfluktsrom i Norge. Appen fungerer uten internett etter første oppsett.',
about_privacy_title: 'Personvern',
about_privacy_body:
'Denne appen samler ikke inn, sender eller deler noen personopplysninger. Det finnes ingen analyse, sporing eller tredjepartstjenester. GPS-posisjonen din brukes bare lokalt på enheten din for å finne tilfluktsrom i nærheten, og sendes aldri til noen server.',
about_data_title: 'Datakilder',
about_data_body:
'Tilfluktsromdata: DSB (Direktoratet for samfunnssikkerhet og beredskap), distribuert via Geonorge. Kartfliser: OpenStreetMap. Begge lagres lokalt for frakoblet bruk.',
about_stored_title: 'Lagret på enheten din',
about_stored_body:
'Tilfluktsromdatabase (offentlige data), kartfliser for frakoblet bruk og kartbuffer-metadata. Ingen data forlater enheten din bortsett fra forespørsler om å laste ned tilfluktsromdata og kartfliser.',
about_copyright: 'Opphavsrett © Ole-Morten Duesund',
about_open_source: 'Åpen kildekode — kode.naiv.no/olemd/tilfluktsrom',
action_about: 'Om',
action_close: 'Lukk',
action_clear_cache: 'Slett lagrede data',
cache_cleared: 'Alle lagrede data slettet',
};

View file

@ -5,20 +5,20 @@ export const nn: Record<string, string> = {
status_ready: 'Klar',
status_loading: 'Lastar tilfluktsromdata\u2026',
status_updating: 'Oppdaterer\u2026',
status_offline: 'Fr\u00e5kopla modus',
status_offline: 'Fråkopla modus',
status_shelters_loaded: '%d tilfluktsrom lasta',
status_no_location: 'Ventar p\u00e5 GPS\u2026',
status_caching_map: 'Lagrar kart for fr\u00e5kopla bruk\u2026',
status_no_location: 'Ventar på GPS\u2026',
status_caching_map: 'Lagrar kart for fråkopla bruk\u2026',
loading_shelters: 'Lastar ned tilfluktsromdata\u2026',
loading_map: 'Lagrar kartfliser\u2026',
loading_map_explanation:
'F\u00f8rebur fr\u00e5kopla kart.\nKartet vil rulle kort for \u00e5 lagre omgjevnadene dine.',
'Førebur fråkopla kart.\nKartet vil rulle kort for å lagre omgjevnadene dine.',
loading_first_time: 'Gjer klar for fyrste gongs bruk\u2026',
shelter_capacity: '%d plassar',
shelter_room_nr: 'Rom %d',
nearest_shelter: 'N\u00e6raste tilfluktsrom',
nearest_shelter: 'Næraste tilfluktsrom',
no_shelters: 'Ingen tilfluktsromdata tilgjengeleg',
action_refresh: 'Oppdater data',
@ -27,18 +27,61 @@ export const nn: Record<string, string> = {
action_cache_ok: 'Lagre kart',
action_cache_now: 'Lagre no',
warning_no_map_cache:
'Ingen fr\u00e5kopla kart lagra. Kartet krev internett.',
'Ingen fråkopla kart lagra. Kartet krev internett.',
permission_location_title: 'Posisjonsløyve krevst',
permission_location_message:
'Denne appen treng posisjonen din for \u00e5 finne n\u00e6raste tilfluktsrom. Ver venleg og gje tilgang til posisjon.',
'Denne appen treng posisjonen din for å finne næraste tilfluktsrom. Ver venleg og gje tilgang til posisjon.',
permission_denied:
'Posisjonsløyve avsl\u00e5tt. Appen kan ikkje finne tilfluktsrom i n\u00e6rleiken utan det.',
'Posisjonsløyve avslått. Appen kan ikkje finne tilfluktsrom i nærleiken utan det.',
error_download_failed:
'Kunne ikkje laste ned tilfluktsromdata. Sjekk internettilkoplinga.',
error_no_data_offline:
'Ingen lagra data tilgjengeleg. Kopla til internett for \u00e5 laste ned tilfluktsromdata.',
'Ingen lagra data tilgjengeleg. Kopla til internett for å laste ned tilfluktsromdata.',
update_success: 'Tilfluktsromdata oppdatert',
update_failed: 'Oppdatering mislukkast \u2014 brukar lagra data',
update_failed: 'Oppdatering mislukkast — brukar lagra data',
error_shelter_not_found: 'Fann ikkje tilfluktsrommet',
// Tilgjenge
direction_arrow_description: 'Retning til tilfluktsrom, %s unna',
a11y_map: 'Kart',
a11y_compass: 'Kompass',
a11y_shelter_info: 'Tilfluktsrominfo',
a11y_nearest_shelters: 'Nærmaste tilfluktsrom',
// Sivilforsvar
action_civil_defense_info: 'Sivilforsvarsinformasjon',
civil_defense_title: 'Kva du skal gjere om alarmen går',
civil_defense_step1_title: '1. Viktig melding-signalet',
civil_defense_step1_body: 'Tre seriar med korte støyt med eitt minutt stille mellom kvar serie. Dette tyder: søk informasjon med ein gong. Slå på DAB-radio, TV, eller sjekk offisielle kjelder på nett.',
civil_defense_step2_title: '2. Flyalarm',
civil_defense_step2_body: 'Korte støyt som varar omtrent eitt minutt. Dette tyder umiddelbar fare for åtak — søk dekning no. Gå til næraste tilfluktsrom, kjellar eller innerrom med ein gong.',
civil_defense_step3_title: '3. Gå innandørs og finn dekning',
civil_defense_step3_body: 'Kom deg innandørs. Lukk alle vindauge, dører og ventilasjonsopningar. Bruk denne appen for å finne næraste offentlege tilfluktsrom. Kompasset og kartet fungerer utan internett. Om det ikkje er noko tilfluktsrom i nærleiken, gå til ein kjellar eller eit innerrom bort frå vindauge.',
civil_defense_step4_title: '4. Lytt til NRK på DAB-radio',
civil_defense_step4_body: 'Lytt til NRK P1 på DAB-radio for offisielle oppdateringar og instruksjonar frå styresmaktene. DAB-radio fungerer sjølv når mobilnettet og internett er nede.',
civil_defense_step5_title: '5. Faren over',
civil_defense_step5_body: 'Éin samanhengande tone på omtrent 30 sekund. Faren eller åtaket er over. Hald fram med å følgje instruksjonar frå styresmaktene.',
civil_defense_source: 'Kjelde: DSB (Direktoratet for samfunnstryggleik og beredskap)',
// Om
about_title: 'Om Tilfluktsrom',
about_description:
'Tilfluktsrom hjelper deg med å finne næraste offentlege tilfluktsrom i Noreg. Appen fungerer utan internett etter fyrste oppsett.',
about_privacy_title: 'Personvern',
about_privacy_body:
'Denne appen samlar ikkje inn, sender eller deler nokon personopplysingar. Det finst ingen analyse, sporing eller tredjepartstenester. GPS-posisjonen din vert berre brukt lokalt på eininga di for å finne tilfluktsrom i nærleiken, og vert aldri sendt til nokon tenar.',
about_data_title: 'Datakjelder',
about_data_body:
'Tilfluktsromdata: DSB (Direktoratet for samfunnstryggleik og beredskap), distribuert via Geonorge. Kartfliser: OpenStreetMap. Begge vert lagra lokalt for fråkopla bruk.',
about_stored_title: 'Lagra på eininga di',
about_stored_body:
'Tilfluktsromdatabase (offentlege data), kartfliser for fråkopla bruk og kartbuffer-metadata. Ingen data forlèt eininga di bortsett frå førespurnader om å laste ned tilfluktsromdata og kartfliser.',
about_copyright: 'Opphavsrett © Ole-Morten Duesund',
about_open_source: 'Open kjeldekode — kode.naiv.no/olemd/tilfluktsrom',
action_about: 'Om',
action_close: 'Lukk',
action_clear_cache: 'Slett lagra data',
cache_cleared: 'Alle lagra data sletta',
};

View file

@ -20,6 +20,21 @@ html, body {
-webkit-text-size-adjust: 100%;
}
/* --- Focus indicators for screen reader / switch access --- */
:focus-visible {
outline: 2px solid #FF6B35;
outline-offset: 2px;
}
/* --- Respect reduced motion preference --- */
@media (prefers-reduced-motion: reduce) {
*, *::before, *::after {
animation-duration: 0.01ms !important;
animation-iteration-count: 1 !important;
transition-duration: 0.01ms !important;
}
}
/* --- App shell layout --- */
#app {
display: flex;
@ -40,17 +55,18 @@ html, body {
#status-text {
flex: 1;
color: #B0BEC5;
color: #CFD8DC;
font-size: 12px;
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
}
#about-btn,
#refresh-btn {
background: none;
border: none;
color: #B0BEC5;
color: #CFD8DC;
cursor: pointer;
padding: 4px;
font-size: 18px;
@ -58,6 +74,7 @@ html, body {
flex-shrink: 0;
}
#about-btn:hover,
#refresh-btn:hover {
color: #ECEFF1;
}
@ -142,8 +159,8 @@ html, body {
height: 40px;
border-radius: 50%;
background: #16213E;
border: 2px solid #B0BEC5;
color: #B0BEC5;
border: 2px solid #CFD8DC;
color: #CFD8DC;
font-size: 18px;
cursor: pointer;
box-shadow: 0 2px 8px rgba(0, 0, 0, 0.4);
@ -263,6 +280,18 @@ html, body {
.shelter-item.selected {
border-color: #FF6B35;
background: rgba(255, 107, 53, 0.1);
padding-left: 20px;
position: relative;
}
.shelter-item.selected::before {
content: '\25B6';
position: absolute;
left: 6px;
top: 50%;
transform: translateY(-50%);
color: #FF6B35;
font-size: 10px;
}
.shelter-item-address {
@ -356,7 +385,7 @@ html, body {
}
.leaflet-control-attribution a {
color: #B0BEC5 !important;
color: #CFD8DC !important;
}
.leaflet-popup-content-wrapper {
@ -370,5 +399,115 @@ html, body {
}
.leaflet-popup-close-button {
color: #B0BEC5 !important;
color: #CFD8DC !important;
}
/* --- About dialog --- */
#about-overlay {
position: fixed;
inset: 0;
background: rgba(0, 0, 0, 0.85);
z-index: 2000;
display: flex;
align-items: center;
justify-content: center;
padding: 16px;
}
.about-content {
background: #16213E;
border-radius: 12px;
padding: 24px;
max-width: 480px;
width: 100%;
max-height: 80vh;
overflow-y: auto;
}
.about-heading {
color: #FF6B35;
font-size: 20px;
font-weight: bold;
margin-bottom: 12px;
}
.about-subheading {
color: #ECEFF1;
font-size: 16px;
font-weight: bold;
margin-top: 16px;
margin-bottom: 4px;
}
.about-para {
color: #90A4AE;
font-size: 14px;
line-height: 1.5;
margin-bottom: 8px;
}
.about-footer {
margin-top: 20px;
padding-top: 12px;
border-top: 1px solid rgba(255, 255, 255, 0.1);
}
.about-small {
color: #90A4AE;
font-size: 11px;
margin-bottom: 2px;
}
#civil-defense-overlay {
position: fixed;
inset: 0;
background: rgba(0, 0, 0, 0.85);
z-index: 2000;
display: flex;
align-items: center;
justify-content: center;
padding: 16px;
}
.about-link-btn {
display: block;
margin: 16px 0 0;
padding: 0;
background: none;
border: none;
color: #FF6B35;
font-size: 14px;
cursor: pointer;
min-height: 48px;
line-height: 48px;
}
.about-clear-btn {
display: block;
margin: 12px 0 0;
padding: 8px 16px;
background: transparent;
border: 1px solid #90A4AE;
border-radius: 6px;
color: #90A4AE;
font-size: 13px;
cursor: pointer;
}
.about-clear-btn:disabled {
border-color: #4a6a5a;
color: #4a6a5a;
cursor: default;
}
.about-close-btn {
display: block;
margin: 16px auto 0;
padding: 10px 32px;
background: #FF6B35;
border: none;
border-radius: 6px;
color: #FFFFFF;
font-size: 14px;
cursor: pointer;
}

122
pwa/src/ui/about-dialog.ts Normal file
View file

@ -0,0 +1,122 @@
/**
* About dialog: app info, privacy statement, data sources, copyright.
* Includes a "Clear cached data" button that removes all local storage.
* Opens as a modal overlay, same pattern as loading-overlay.
*/
import { t } from '../i18n/i18n';
let overlay: HTMLDivElement | null = null;
let previousFocus: HTMLElement | null = null;
/** Show the about dialog. */
export function showAbout(): void {
if (overlay) return;
previousFocus = document.activeElement as HTMLElement | null;
overlay = document.createElement('div');
overlay.id = 'about-overlay';
overlay.setAttribute('role', 'dialog');
overlay.setAttribute('aria-modal', 'true');
overlay.setAttribute('aria-label', t('about_title'));
const content = document.createElement('div');
content.className = 'about-content';
content.appendChild(heading(t('about_title')));
content.appendChild(para(t('about_description')));
content.appendChild(subheading(t('about_privacy_title')));
content.appendChild(para(t('about_privacy_body')));
content.appendChild(subheading(t('about_data_title')));
content.appendChild(para(t('about_data_body')));
content.appendChild(subheading(t('about_stored_title')));
content.appendChild(para(t('about_stored_body')));
// Clear cache button
const clearBtn = document.createElement('button');
clearBtn.className = 'about-clear-btn';
clearBtn.textContent = t('action_clear_cache');
clearBtn.addEventListener('click', () => clearAllData(clearBtn));
content.appendChild(clearBtn);
const footer = document.createElement('div');
footer.className = 'about-footer';
footer.appendChild(small(t('about_copyright')));
footer.appendChild(small(t('about_open_source')));
content.appendChild(footer);
const closeBtn = document.createElement('button');
closeBtn.className = 'about-close-btn';
closeBtn.textContent = t('action_close');
closeBtn.addEventListener('click', hideAbout);
content.appendChild(closeBtn);
overlay.appendChild(content);
document.body.appendChild(overlay);
closeBtn.focus();
}
/** Hide the about dialog and restore focus. */
export function hideAbout(): void {
if (overlay) {
overlay.remove();
overlay = null;
}
previousFocus?.focus();
previousFocus = null;
}
/** Clear all cached data: IndexedDB, localStorage, and service worker caches. */
async function clearAllData(btn: HTMLButtonElement): Promise<void> {
btn.disabled = true;
// Clear localStorage (map cache metadata)
localStorage.clear();
// Clear IndexedDB (shelter database)
const dbs = await indexedDB.databases?.() ?? [];
for (const db of dbs) {
if (db.name) indexedDB.deleteDatabase(db.name);
}
// Clear service worker caches (map tiles, precache)
const cacheNames = await caches.keys();
for (const name of cacheNames) {
await caches.delete(name);
}
btn.textContent = t('cache_cleared');
}
function heading(text: string): HTMLElement {
const el = document.createElement('h2');
el.textContent = text;
el.className = 'about-heading';
return el;
}
function subheading(text: string): HTMLElement {
const el = document.createElement('h3');
el.textContent = text;
el.className = 'about-subheading';
return el;
}
function para(text: string): HTMLElement {
const el = document.createElement('p');
el.textContent = text;
el.className = 'about-para';
return el;
}
function small(text: string): HTMLElement {
const el = document.createElement('p');
el.textContent = text;
el.className = 'about-small';
return el;
}

Some files were not shown because too many files have changed in this diff Show more