feat: add share intake and shared map link parsing functionality

- Implemented share intake service with tests for normalizing external links.
- Added shared map link parser with support for various map providers and coordinate extraction.
- Integrated share intent handling for incoming shared links in the mobile app.
- Updated planning document to reflect progress on location share links feature.
- Added patch for xcode dependency to resolve known issues.

Author: Lalit Sharma

CHANGELOG.md

@@ -5,6 +5,21 @@ 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.1.41] — 2026-02-27
+
+### Added
+- Added shared map-link parsing support for Apple Maps and Google Maps links, including coordinate extraction from query params and Google `@lat,lon` path tokens.
+- Added short-link redirect expansion support for `maps.app.goo.gl` with timeout-safe fallback behavior.
+- Added shared-link intake utilities and tests to normalize incoming linking/share payloads and keep parsing behavior deterministic.
+- Added Android `ACTION_SEND` (`text/*`) intent filter to accept shared text/map URLs in the tracked native manifest.
+
+### Changed
+- Integrated incoming map-link handling into `RootNavigator` so supported links navigate to `Timer`, jump the pin to parsed coordinates, and show `Location loaded from shared map link`.
+- Added shared-link dedupe guarding to avoid duplicate processing during cold-start intake (`getInitialURL` + runtime URL events).
+- Added `expo-share-intent` integration and wiring so share-target payloads feed the same parser/navigation pipeline as deep links.
+- Added pnpm `patchedDependencies` entry and `xcode@3.0.1` patch hardening to avoid known share-extension config-sync failures during native config generation.
+- Bumped `apps/mobile` version to `1.1.41`.
+
 ## [1.1.40] — 2026-02-27
 
 ### Fixed

apps/mobile/android/app/src/main/AndroidManifest.xml

@@ -31,6 +31,11 @@
         <category android:name="android.intent.category.BROWSABLE"/>
         <data android:scheme="eclipsetimer"/>
       </intent-filter>
+      <intent-filter>
+        <action android:name="android.intent.action.SEND"/>
+        <category android:name="android.intent.category.DEFAULT"/>
+        <data android:mimeType="text/*"/>
+      </intent-filter>
     </activity>
     <service android:name=".wearable.WearDataLayerListenerService" android:exported="true">
       <intent-filter>

apps/mobile/app.json

@@ -83,6 +83,12 @@
     },
     "plugins": [
       "expo-notifications",
+      [
+        "expo-share-intent",
+        {
+          "disableAndroid": true
+        }
+      ],
       [
         "expo-location",
         {

apps/mobile/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eclipse-timer/mobile",
-  "version": "1.1.40",
+  "version": "1.1.41",
   "private": true,
   "main": "index.js",
   "scripts": {
@@ -22,8 +22,11 @@
     "@react-navigation/native-stack": "^7.12.0",
     "@sentry/react-native": "^7.2.0",
     "expo": "~54.0.33",
+    "expo-constants": "~18.0.10",
+    "expo-linking": "~8.0.9",
     "expo-location": "~19.0.8",
     "expo-notifications": "~0.32.16",
+    "expo-share-intent": "5.1.1",
     "expo-speech": "^14.0.8",
     "expo-splash-screen": "^31.0.13",
     "expo-updates": "^29.0.16",

apps/mobile/src/navigation/RootNavigator.tsx

@@ -24,6 +24,7 @@ import {
   createNativeStackNavigator,
   type NativeStackScreenProps,
 } from "@react-navigation/native-stack";
+import { useShareIntent } from "expo-share-intent";
 import * as SplashScreen from "expo-splash-screen";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import {
@@ -54,12 +55,18 @@ import PhotographyGuideScreen, {
 import SettingsScreen from "../screens/SettingsScreen";
 import ThemeSettingsScreen from "../screens/ThemeSettingsScreen";
 import TimerScreen from "../screens/TimerScreen";
+import {
+  type IncomingExternalLink,
+  normalizeSharePayloadToIncomingLinks,
+  subscribeToIncomingExternalLinks,
+} from "../services/shareIntake";
 import { syncWearPreviewRouteState } from "../services/wearPreviewPublisher";
 import { startWearLiveSync } from "../services/wearSync";
 import { type FavoriteLocation, useAppState } from "../state/appState";
 import { useAppTheme } from "../theme/useAppTheme";
 import { localYmdNow } from "../utils/date";
 import { kindCodeForRecord, kindLabelFromCode } from "../utils/eclipse";
+import { type ParsedSharedMapLink, parseSharedMapLinkAsync } from "../utils/sharedMapLink";
 import FirstRunOnboardingOverlay from "./FirstRunOnboardingOverlay";
 import { ONBOARDING_WALKTHROUGH_STEPS, type OnboardingRouteName } from "./onboardingWalkthrough";
 import SideMenu, { type MenuRouteName } from "./SideMenu";
@@ -104,6 +111,8 @@ type LandingRouteProps = NativeStackScreenProps<RootStackParamList, "Landing"> &
 type TimerRouteProps = NativeStackScreenProps<RootStackParamList, "Timer"> & {
   catalog: EclipseRecord[];
   onOpenMenu: () => void;
+  pendingSharedLocation: PendingSharedLocation | null;
+  onConsumePendingSharedLocation: (id: string) => void;
 };
 
 type PreviewRouteProps = NativeStackScreenProps<RootStackParamList, "Preview"> & {
@@ -197,6 +206,13 @@ type FeaturedEclipseDeepLinkAction =
   | { type: "open_timer"; eclipseId: string }
   | { type: "open_preview"; eclipseId: string };
 
+type PendingSharedLocation = ParsedSharedMapLink & {
+  id: string;
+};
+
+const INCOMING_EXTERNAL_LINK_DEDUPE_WINDOW_MS = 5_000;
+const MAX_TRACKED_INCOMING_EXTERNAL_LINKS = 20;
+
 const FEATURED_ECLIPSE_BY_SLUG: Record<string, string> = {
   "2026-total": "2026-08-12T",
   "2027-total": "2027-08-02T",
@@ -322,9 +338,16 @@ function LandingRoute({ navigation, catalog, onOpenMenu }: LandingRouteProps) {
   );
 }
 
-function TimerRoute({ navigation, catalog, onOpenMenu }: TimerRouteProps) {
+function TimerRoute({
+  navigation,
+  catalog,
+  onOpenMenu,
+  pendingSharedLocation,
+  onConsumePendingSharedLocation,
+}: TimerRouteProps) {
   const { state, actions } = useAppState();
   const isFocused = useIsFocused();
+  const lastAppliedSharedLocationIdRef = useRef<string | null>(null);
   const [activeEclipse, setActiveEclipse] = useState<EclipseRecord | null>(null);
   const [isActiveEclipseLoading, setIsActiveEclipseLoading] = useState(false);
   const todayYmd = useMemo(() => localYmdNow(), []);
@@ -383,6 +406,16 @@ function TimerRoute({ navigation, catalog, onOpenMenu }: TimerRouteProps) {
     actions.removeEclipseReminderAnchor,
   );
 
+  useEffect(() => {
+    if (!pendingSharedLocation) return;
+    if (lastAppliedSharedLocationIdRef.current === pendingSharedLocation.id) return;
+
+    lastAppliedSharedLocationIdRef.current = pendingSharedLocation.id;
+    timerState.jumpTo(pendingSharedLocation.lat, pendingSharedLocation.lon, 2);
+    timerState.setStatusMessage("Location loaded from shared map link");
+    onConsumePendingSharedLocation(pendingSharedLocation.id);
+  }, [onConsumePendingSharedLocation, pendingSharedLocation, timerState]);
+
   useInAppAlarmEngine({
     isRouteFocused: isFocused,
     activeEclipseId: state.activeEclipseId,
@@ -575,9 +608,17 @@ function LocationSettingsRoute({ onOpenMenu }: RouteWithMenuProps) {
 export default function RootNavigator() {
   const { state: appState, hasHydratedPreferences, actions } = useAppState();
   const { colors, resolvedTheme } = useAppTheme();
+  const { hasShareIntent, shareIntent, resetShareIntent } = useShareIntent({
+    resetOnBackground: false,
+  });
   const navigationRef = useNavigationContainerRef<RootStackParamList>();
   const pendingFeaturedDeepLinkActionRef = useRef<FeaturedEclipseDeepLinkAction | null>(null);
+  const sharedLocationSequenceRef = useRef(0);
+  const recentIncomingExternalLinksRef = useRef<Array<{ value: string; receivedAtMs: number }>>([]);
   const [catalog, setCatalog] = useState<EclipseRecord[] | null>(null);
+  const [pendingSharedLocation, setPendingSharedLocation] = useState<PendingSharedLocation | null>(
+    null,
+  );
   const [isMenuOpen, setIsMenuOpen] = useState(false);
   const [onboardingStepIndex, setOnboardingStepIndex] = useState(0);
   const [currentRouteName, setCurrentRouteName] = useState<keyof RootStackParamList>("Landing");
@@ -686,29 +727,98 @@ export default function RootNavigator() {
     [activateEclipseById, closeMenu, navigationRef],
   );
 
+  const queuePendingSharedLocation = useCallback(
+    (link: ParsedSharedMapLink) => {
+      sharedLocationSequenceRef.current += 1;
+      const pending: PendingSharedLocation = {
+        ...link,
+        id: `shared-location-${sharedLocationSequenceRef.current}`,
+      };
+
+      setPendingSharedLocation(pending);
+      closeMenu();
+
+      if (!navigationRef.isReady()) return;
+      navigationRef.navigate("Timer");
+    },
+    [closeMenu, navigationRef],
+  );
+
+  const consumePendingSharedLocation = useCallback((id: string) => {
+    setPendingSharedLocation((current) => (current?.id === id ? null : current));
+  }, []);
+
+  const shouldProcessIncomingExternalLink = useCallback((value: string) => {
+    const nowMs = Date.now();
+    const cutoffMs = nowMs - INCOMING_EXTERNAL_LINK_DEDUPE_WINDOW_MS;
+    const recent = recentIncomingExternalLinksRef.current.filter(
+      (entry) => entry.receivedAtMs >= cutoffMs,
+    );
+    const isDuplicate = recent.some((entry) => entry.value === value);
+    if (isDuplicate) {
+      recentIncomingExternalLinksRef.current = recent;
+      return false;
+    }
+
+    recent.push({ value, receivedAtMs: nowMs });
+    if (recent.length > MAX_TRACKED_INCOMING_EXTERNAL_LINKS) {
+      recent.splice(0, recent.length - MAX_TRACKED_INCOMING_EXTERNAL_LINKS);
+    }
+    recentIncomingExternalLinksRef.current = recent;
+    return true;
+  }, []);
+
   const handleIncomingUrl = useCallback(
-    (url: string) => {
-      const action = parseFeaturedEclipseDeepLink(url);
-      if (!action) return false;
+    async (incoming: IncomingExternalLink) => {
+      if (!shouldProcessIncomingExternalLink(incoming.value)) {
+        return false;
+      }
 
-      if (!navigationRef.isReady()) {
-        pendingFeaturedDeepLinkActionRef.current = action;
+      const action = parseFeaturedEclipseDeepLink(incoming.value);
+      if (action) {
+        if (!navigationRef.isReady()) {
+          pendingFeaturedDeepLinkActionRef.current = action;
+          return true;
+        }
+
+        runFeaturedDeepLinkAction(action);
         return true;
       }
 
-      runFeaturedDeepLinkAction(action);
+      const sharedMapLink = await parseSharedMapLinkAsync(incoming.value);
+      if (!sharedMapLink) return false;
+
+      queuePendingSharedLocation(sharedMapLink);
       return true;
     },
-    [navigationRef, runFeaturedDeepLinkAction],
+    [
+      navigationRef,
+      queuePendingSharedLocation,
+      runFeaturedDeepLinkAction,
+      shouldProcessIncomingExternalLink,
+    ],
   );
 
   const onNavigationReady = useCallback(() => {
     syncWearPreviewWithRoute();
     const pendingAction = pendingFeaturedDeepLinkActionRef.current;
-    if (!pendingAction) return;
-    pendingFeaturedDeepLinkActionRef.current = null;
-    runFeaturedDeepLinkAction(pendingAction);
-  }, [runFeaturedDeepLinkAction, syncWearPreviewWithRoute]);
+    if (pendingAction) {
+      pendingFeaturedDeepLinkActionRef.current = null;
+      runFeaturedDeepLinkAction(pendingAction);
+      return;
+    }
+
+    if (pendingSharedLocation) {
+      closeMenu();
+      navigationRef.navigate("Timer");
+    }
+  }, [
+    closeMenu,
+    navigationRef,
+    pendingSharedLocation,
+    runFeaturedDeepLinkAction,
+    syncWearPreviewWithRoute,
+  ]);
 
   const onNavigateFromMenu = useCallback(
     (route: MenuRouteName) => {
@@ -807,23 +917,33 @@ export default function RootNavigator() {
   }, []);
 
   useEffect(() => {
-    const subscription = Linking.addEventListener("url", ({ url }) => {
-      handleIncomingUrl(url);
-    });
+    return subscribeToIncomingExternalLinks(
+      (incoming) => {
+        void handleIncomingUrl(incoming);
+      },
+      { linking: Linking },
+    );
+  }, [handleIncomingUrl]);
 
-    void Linking.getInitialURL()
-      .then((url) => {
-        if (!url) return;
-        handleIncomingUrl(url);
-      })
-      .catch(() => {
-        // Ignore URL parsing failures and allow default linking behavior.
-      });
+  useEffect(() => {
+    if (!hasShareIntent) return;
 
-    return () => {
-      subscription.remove();
-    };
-  }, [handleIncomingUrl]);
+    const shareIncomingLinks = normalizeSharePayloadToIncomingLinks({
+      webUrl: shareIntent.webUrl,
+      text: shareIntent.text,
+    });
+    if (!shareIncomingLinks.length) {
+      resetShareIntent();
+      return;
+    }
+
+    void (async () => {
+      for (const incoming of shareIncomingLinks) {
+        await handleIncomingUrl(incoming);
+      }
+      resetShareIntent();
+    })();
+  }, [handleIncomingUrl, hasShareIntent, resetShareIntent, shareIntent.text, shareIntent.webUrl]);
 
   if (!catalog) {
     return <StartupLoadingScreen message="Loading eclipse catalog..." colors={colors} />;
@@ -843,7 +963,15 @@ export default function RootNavigator() {
             {(props) => <LandingRoute {...props} catalog={catalog} onOpenMenu={openMenu} />}
           </Stack.Screen>
           <Stack.Screen name="Timer">
-            {(props) => <TimerRoute {...props} catalog={catalog} onOpenMenu={openMenu} />}
+            {(props) => (
+              <TimerRoute
+                {...props}
+                catalog={catalog}
+                onOpenMenu={openMenu}
+                pendingSharedLocation={pendingSharedLocation}
+                onConsumePendingSharedLocation={consumePendingSharedLocation}
+              />
+            )}
           </Stack.Screen>
           <Stack.Screen name="Preview">
             {(props) => <PreviewRoute {...props} onOpenMenu={openMenu} />}