Naturbeobachtungen (iNaturalist-App)
Eine deutschsprachige Progressive Web App rund um iNaturalist-Beobachtungen:
Weltkarte, Galerie, Arten- und Erstbeobachtungen im Zeitraum, Seltenheits-Dashboard,
Saison-Challenges & Badges, Freundevergleich, Statistiken und „In meiner Nähe".
Aufbau
index.html – die komplette Frontend-App (Vanilla-JS, kein Build-Schritt). Leaflet für Karten.api/ – Vercel Serverless Functions (Node, ESM):
inat.js – Proxy/Cache für die iNaturalist-APIfriends.js, seen.js, badgelevels.js, state.js – geräteübergreifender Zustand (Upstash Redis)subscribe.js, vapid.js, test-push.js, cron/notify.js – Web-Push-Benachrichtigungenhealth.js – Health-Check · _redis.js – Redis-Client-Helfer
service-worker.js – PWA-Shell (network-first) + Push-Handlingmanifest.json, Icons – PWA-Metadaten_dev/ – lokale Preview-/Demo-Seiten (nicht deployt, via .gitignore ausgeschlossen)
Entwicklung & Deployment
Kein Build nötig – statisches Frontend + Serverless-Functions, gehostet auf Vercel
(GitHub Pages als Fallback). Konfiguration in vercel.json (Cron, Header). Benötigte
Env-Variablen: KV_REST_API_URL/KV_REST_API_TOKEN (Redis), VAPID_PUBLIC_KEY/
VAPID_PRIVATE_KEY/VAPID_SUBJECT (Push), CRON_SECRET.
Nach Änderungen an index.html/service-worker.js die Cache-Version im
Service Worker (inat-shell-vN) hochzählen, damit Nutzer den neuen Stand erhalten.
