chore: add husky and lint-staged for pre-commit hooks

- Added husky as a dev dependency to manage Git hooks.
- Configured lint-staged to run biome checks on staged files.
- Updated package.json scripts to include a prepare script for husky.
- Updated pnpm-lock.yaml to include new dependencies and their versions.

Author: Lalit Sharma

.husky/pre-commit

@@ -0,0 +1 @@
+pnpm lint-staged

.nvmrc

@@ -0,0 +1 @@
+20

CHANGELOG.md

@@ -0,0 +1,41 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] — 2026-02-16
+
+### Added
+- **Eclipse catalog** — 200+ solar eclipses (1900–2100) with Besselian element polynomials, sourced from NASA data.
+- **Eclipse engine** — computes five contact points (C1/C2/max/C3/C4), magnitude, obscuration, and eclipse kind for any observer location.
+- **Interactive map** — tap or drag a pin to set observer location; toggle satellite/hybrid views.
+- **Overlay paths** — penumbral and umbral/antumbral shadow paths rendered on the map, loaded lazily by decade.
+- **GPS location** — one-tap "Use GPS" with pre-permission rationale dialog; location stays on-device.
+- **Live countdown** — ticking countdown to the next eclipse contact event.
+- **Local time display** — contact times shown in both UTC and device-local time.
+- **Search & filter** — tokenized search on the eclipse landing list (by year, date, kind, ID).
+- **Notifications** — per-contact local notification scheduling with configurable reminder lead times, sound, vibration, and TTS audio modes.
+- **Notification settings** — dedicated screen for global and per-eclipse notification preferences, persisted via AsyncStorage.
+- **NASA GIF preview** — prefetched/cached eclipse animation preview with loading placeholder and error fallback.
+- **Error boundary** — catches runtime crashes with a recovery UI and Sentry reporting.
+- **Sentry crash reporting** — `@sentry/react-native` integration (production-only).
+- **Splash screen control** — native splash held until catalog loads via `expo-splash-screen`.
+- **Accessibility** — labels, roles, and states on all interactive elements (landing + notification settings screens).
+- **Privacy policy** — `PRIVACY_POLICY.md` covering location, Sentry, NASA GIF, notifications; iOS privacy manifest in `app.json`.
+- **Store metadata** — descriptions, keywords, content rating answers, icon (alpha-stripped for iOS) in `documents/store-metadata.md`.
+- **CI/CD** — GitHub Actions CI (typecheck/lint/test), EAS Build + Submit workflow, `expo-updates` OTA support.
+- **Pre-commit hooks** — Husky + lint-staged running Biome check on staged files.
+- **EAS Build profiles** — `development`, `preview`, `production` in `eas.json`.
+
+### Changed
+- Refactored `App.tsx` from ~1 000-line god component into screens, hooks, and utilities.
+- Replaced `ScrollView` + `.map()` with virtualized `FlatList` on landing screen.
+- Engine magnitude formula uses geometric `(L1obs - Δ) / (L1obs + L2obs)` instead of hardcoded `1`.
+- Overlay polygons loaded lazily by decade instead of monolithic JSON.
+- `evaluateAtT` results cached per-`t` during contact solving to avoid duplicate evaluations.
+
+### Fixed
+- Countdown timer now ticks in real time (was static).
+- GPS altitude wired through to engine `elevM` (was hardcoded to 0).

apps/mobile/.env.example

@@ -0,0 +1,10 @@
+# Environment variables for Eclipse Timer
+# Copy this file to .env and fill in real values before production builds.
+
+# Sentry — crash reporting (used in App.tsx Sentry.init)
+SENTRY_DSN=
+SENTRY_ORG=
+SENTRY_PROJECT=
+
+# EAS — set automatically by EAS Build, but useful locally
+EXPO_PROJECT_ID=a29a7662-96be-4509-a79e-fbe4b5dac1ff

apps/mobile/src/hooks/useTimerState.ts

@@ -1,17 +1,20 @@
-import { useCallback, useEffect, useMemo, useRef, useState, type RefObject } from "react";
-import { Animated, Alert, InteractionManager } from "react-native";
-import type { Details, MapPressEvent, Region } from "react-native-maps";
-import type MapView from "react-native-maps";
-import * as Location from "expo-location";
-
 import { computeCircumstances } from "@eclipse-timer/engine";
 import type { Circumstances, EclipseRecord, Observer } from "@eclipse-timer/shared";
-
+import * as Location from "expo-location";
+import { type RefObject, useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { Alert, Animated, InteractionManager } from "react-native";
+import type MapView from "react-native-maps";
+import type { Details, MapPressEvent, Region } from "react-native-maps";
+import {
+  type NotificationEntry,
+  type NotificationSettings,
+  notificationEntryId,
+} from "../state/appState";
 import {
   buildContactItems,
-  nextEventCountdown,
   type ContactItem,
   type ContactKey,
+  nextEventCountdown,
 } from "../utils/contacts";
 import {
   normalizeLongitude,
@@ -20,17 +23,12 @@ import {
   sanitizeLatitude,
   sanitizeRegion,
 } from "../utils/map";
-import {
-  notificationEntryId,
-  type NotificationEntry,
-  type NotificationSettings,
-} from "../state/appState";
 
 type MapType3 = "standard" | "satellite" | "hybrid";
 
 type AlarmState = Record<ContactKey, boolean>;
 
-type Pin = { lat: number; lon: number };
+type Pin = { lat: number; lon: number; elevM: number };
 type MarkerDragEndEvent = {
   nativeEvent: {
     coordinate: {
@@ -40,7 +38,7 @@ type MarkerDragEndEvent = {
   };
 };
 
-const GIBRALTAR = { lat: 36.1408, lon: -5.3536 };
+const GIBRALTAR: Pin = { lat: 36.1408, lon: -5.3536, elevM: 0 };
 const MIN_REGION_DIFF = 0.00001;
 const MIN_PIN_DIFF = 0.000001;
 const EMPTY_ALARM_STATE: AlarmState = {
@@ -66,7 +64,9 @@ function hasMeaningfulRegionChange(prev: Region, next: Region): boolean {
 }
 
 function hasMeaningfulPinChange(prev: Pin, next: Pin): boolean {
-  return Math.abs(prev.lat - next.lat) > MIN_PIN_DIFF || Math.abs(prev.lon - next.lon) > MIN_PIN_DIFF;
+  return (
+    Math.abs(prev.lat - next.lat) > MIN_PIN_DIFF || Math.abs(prev.lon - next.lon) > MIN_PIN_DIFF
+  );
 }
 
 export type TimerState = {
@@ -114,7 +114,7 @@ export function useTimerState(
   removeNotificationEntry: (id: string) => void,
 ): TimerState {
   const mapRef = useRef<MapView>(null);
-  const [pin, setPin] = useState<Pin>({ lat: GIBRALTAR.lat, lon: GIBRALTAR.lon });
+  const [pin, setPin] = useState<Pin>({ lat: GIBRALTAR.lat, lon: GIBRALTAR.lon, elevM: 0 });
   const [mapType, setMapType] = useState<MapType3>("standard");
   const [showVisibleOverlay, setShowVisibleOverlay] = useState(true);
   const [showCentralOverlay, setShowCentralOverlay] = useState(true);
@@ -219,11 +219,11 @@ export function useTimerState(
     setShowDirectionsOverlay((prev) => !prev);
   };
 
-  const jumpTo = (lat: number, lon: number, delta = 3) => {
+  const jumpTo = (lat: number, lon: number, delta = 3, elevM = 0) => {
     const safeLat = sanitizeLatitude(lat);
     const safeLon = normalizeLongitude(lon);
     const safeDelta = sanitizeDelta(delta, 3);
-    const nextPin: Pin = { lat: safeLat, lon: safeLon };
+    const nextPin: Pin = { lat: safeLat, lon: safeLon, elevM };
     const nextRegion: Region = {
       latitude: safeLat,
       longitude: safeLon,
@@ -250,7 +250,7 @@ export function useTimerState(
   const movePinKeepZoom = (lat: number, lon: number) => {
     const safeLat = sanitizeLatitude(lat);
     const safeLon = normalizeLongitude(lon);
-    const nextPin: Pin = { lat: safeLat, lon: safeLon };
+    const nextPin: Pin = { lat: safeLat, lon: safeLon, elevM: 0 };
     const pinMoved = hasMeaningfulPinChange(pin, nextPin);
 
     if (pinMoved) {
@@ -310,7 +310,8 @@ export function useTimerState(
 
       const last = await Location.getLastKnownPositionAsync();
       if (last?.coords) {
-        jumpTo(last.coords.latitude, last.coords.longitude, 2);
+        const alt = last.coords.altitude ?? 0;
+        jumpTo(last.coords.latitude, last.coords.longitude, 2, alt);
         setStatus("Pin set from last known location");
       }
 
@@ -330,7 +331,8 @@ export function useTimerState(
       ]);
 
       if (current?.coords) {
-        jumpTo(current.coords.latitude, current.coords.longitude, 2);
+        const alt = current.coords.altitude ?? 0;
+        jumpTo(current.coords.latitude, current.coords.longitude, 2, alt);
         setStatus("Pin set from GPS");
       } else if (!last) {
         setStatus("GPS timed out (try again or move near a window)");
@@ -346,7 +348,7 @@ export function useTimerState(
       return;
     }
 
-    const observer: Observer = { latDeg: pin.lat, lonDeg: pin.lon, elevM: 0 };
+    const observer: Observer = { latDeg: pin.lat, lonDeg: pin.lon, elevM: pin.elevM };
 
     cancelPendingCompute();
     const runToken = computeRunTokenRef.current;
@@ -364,7 +366,7 @@ export function useTimerState(
         if (computeRunTokenRef.current !== runToken) return;
 
         setResult(out);
-        setResultPin({ lat: observer.latDeg, lon: observer.lonDeg });
+        setResultPin({ lat: observer.latDeg, lon: observer.lonDeg, elevM: observer.elevM ?? 0 });
         setStatus("Computed");
 
         resultFlash.setValue(0);