feat(analytics): migrate from Firebase Analytics to Amplitude

.env.example

@@ -62,32 +62,11 @@ GOOGLE_SECRET=your-google-client-secret
 # APPLE_CLIENT_ID=your-apple-service-id-here
 
 # ==============================================================================
-# FIREBASE ANALYTICS
+# AMPLITUDE ANALYTICS
 # ==============================================================================
-# Firebase Console: https://console.firebase.google.com/project/sobers
-#
-# --- Web Platform (env vars) ---
-# Get these from: Firebase Console > Project Settings > Your apps > Web app
-EXPO_PUBLIC_FIREBASE_API_KEY=
-EXPO_PUBLIC_FIREBASE_PROJECT_ID=
-EXPO_PUBLIC_FIREBASE_APP_ID=
-EXPO_PUBLIC_FIREBASE_MEASUREMENT_ID=
-
-# --- Native Platforms (config files - NOT committed to git) ---
-# Download from Firebase Console > Project Settings > Your apps
-#
-# iOS: GoogleService-Info.plist
-#   1. Download from Firebase Console
-#   2. Place in project root: ./GoogleService-Info.plist
-#   3. Run `npx expo prebuild` to copy to ios/
-#
-# Android: google-services.json
-#   1. Download from Firebase Console
-#   2. Place in project root: ./google-services.json
-#   3. Run `npx expo prebuild` to copy to android/app/
-#
-# IMPORTANT: These files contain API keys and are gitignored.
-# Each developer must download their own copy from Firebase Console.
+# Amplitude Dashboard: https://app.amplitude.com
+# Get API key from: Settings > Projects > [Your Project] > General
+EXPO_PUBLIC_AMPLITUDE_API_KEY=your-amplitude-api-key-here
 
 # Optional: Enable debug mode for analytics (shows events in console)
 EXPO_PUBLIC_ANALYTICS_DEBUG=false

CHANGELOG.md

@@ -9,6 +9,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- Add Amplitude Analytics integration for product analytics with native and web platform support
+- Add 35+ analytics events with Title Case naming (e.g., "Screen Viewed", "Task Completed") for comprehensive user engagement tracking
+- Add 9 user properties for cohort analysis: days_sober_bucket, steps_completed_bucket, has_sponsor, has_sponsees, theme_preference, notifications_enabled, app_version, platform, device_type
 - Add password visibility toggle to Login and Signup screens with accessible labels
 - Add testIDs for password toggle buttons to improve test selectability
 - Add tests for password visibility toggle functionality in login and signup screens
@@ -18,20 +21,35 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Add Build Info conditional rendering tests for SettingsContent
 - Add handleSaveName edge case tests for SettingsContent
 - Add handleToggleSavingsCard tests for SettingsContent
+- Add TaskCard accessibility tests for status icon labels and due date announcements
+- Add analytics platform tests for uninitialized state and edge cases
+- Add Sentry Spotlight for local development error debugging (`pnpm spotlight`)
+- Add complete AnalyticsEvents constant assertions covering all 35 event types to catch renamed/removed constants
+- Add comprehensive onboarding analytics tracking (ONBOARDING_STARTED, ONBOARDING_SCREEN_VIEWED, ONBOARDING_FIELD_COMPLETED, ONBOARDING_STEP_COMPLETED, ONBOARDING_SOBRIETY_DATE_SET, ONBOARDING_COMPLETED, ONBOARDING_ABANDONED)
+- Add analytics tracking for settings changes (SETTINGS_CHANGED event for theme and dashboard preferences)
+- Add analytics tracking for app engagement (APP_OPENED, APP_BACKGROUNDED, APP_SESSION_STARTED, DAILY_CHECK_IN events)
+- Add analytics tracking for savings updates (SAVINGS_UPDATED event when editing savings settings)
 
 ### Changed
 
+- Replace Firebase Analytics with Amplitude SDK for improved cross-platform analytics support
+- Update analytics module architecture with platform-specific implementations (native/web) using Metro bundler resolution
 - Lower branch coverage threshold from 85% to 83% to account for untestable code paths (DevToolsSection, platform-specific conditionals)
 
+### Removed
+
+- Remove Firebase Analytics dependencies (@react-native-firebase/analytics, @react-native-firebase/app)
+- Remove Firebase configuration files and plugins (firebase.json, withFirebaseConfig.js, withModularHeaders.js)
+- Remove check for updates feature and expo-updates dependency from the app
+
 ### Fixed
 
 - Fix E2E savings tests failing due to incorrect card click (menu button required)
 - Improve test coverage: add tests for alert module public API, SettingsContent build info, and savings card toggle
 - Fix keyboard pushing content up excessively in EditSavingsSheet by using single snap point
-
-### Removed
-
-- Remove check for updates feature and expo-updates dependency from the app
+- Fix TaskCard syntax error causing build failure (broken JSX from accessibility enhancement)
+- Fix analytics initialization errors being swallowed, preventing retry on failure
+- Fix calculateStepsCompletedBucket returning incorrect bucket for negative values
 
 ## [1.2.1] - 2025-12-25
 

__tests__/app/layout.test.tsx

@@ -140,6 +140,7 @@ jest.mock('@/lib/analytics', () => ({
   setUserId: jest.fn(),
   setUserProperties: jest.fn(),
   resetAnalytics: jest.fn(),
+  AnalyticsEvents: jest.requireActual('@/types/analytics').AnalyticsEvents,
 }));
 
 // =============================================================================

__tests__/components/tasks/TaskCard.test.tsx

@@ -334,6 +334,84 @@ describe('TaskCard', () => {
       const deleteButton = screen.getByLabelText('Delete task Complete Step 1');
       expect(deleteButton).toBeTruthy();
     });
+
+    describe('Status Icon Labels', () => {
+      it('announces completed status for my-task variant', () => {
+        render(<TaskCard task={mockTask} theme={mockTheme} variant="my-task" isCompleted={true} />);
+
+        expect(screen.getByLabelText('Status: Completed')).toBeTruthy();
+      });
+
+      it('announces completed status for managed-task variant', () => {
+        const completedTask = { ...mockTask, status: 'completed' as const };
+
+        render(<TaskCard task={completedTask} theme={mockTheme} variant="managed-task" />);
+
+        expect(screen.getByLabelText('Status: Completed')).toBeTruthy();
+      });
+
+      it('announces overdue status for managed-task variant', () => {
+        render(
+          <TaskCard task={mockTask} theme={mockTheme} variant="managed-task" isOverdue={true} />
+        );
+
+        expect(screen.getByLabelText('Status: Overdue')).toBeTruthy();
+      });
+
+      it('announces assigned status for managed-task variant', () => {
+        const assignedTask = { ...mockTask, status: 'assigned' as const };
+
+        render(
+          <TaskCard
+            task={assignedTask}
+            theme={mockTheme}
+            variant="managed-task"
+            isCompleted={false}
+            isOverdue={false}
+          />
+        );
+
+        expect(screen.getByLabelText('Status: Assigned')).toBeTruthy();
+      });
+
+      it('announces in progress status for managed-task variant', () => {
+        const inProgressTask = { ...mockTask, status: 'in_progress' as const };
+
+        render(
+          <TaskCard
+            task={inProgressTask}
+            theme={mockTheme}
+            variant="managed-task"
+            isCompleted={false}
+            isOverdue={false}
+          />
+        );
+
+        expect(screen.getByLabelText('Status: In Progress')).toBeTruthy();
+      });
+    });
+
+    describe('Due Date Labels', () => {
+      it('announces due date for my-task variant', () => {
+        render(<TaskCard task={mockTask} theme={mockTheme} variant="my-task" />);
+
+        expect(screen.getByLabelText(/^Due /)).toBeTruthy();
+      });
+
+      it('announces due date for managed-task variant', () => {
+        render(<TaskCard task={mockTask} theme={mockTheme} variant="managed-task" />);
+
+        expect(screen.getByLabelText(/^Due /)).toBeTruthy();
+      });
+
+      it('announces overdue due date for managed-task variant', () => {
+        render(
+          <TaskCard task={mockTask} theme={mockTheme} variant="managed-task" isOverdue={true} />
+        );
+
+        expect(screen.getByLabelText(/^Due .*, Overdue$/)).toBeTruthy();
+      });
+    });
   });
 
   describe('Edge Cases', () => {

__tests__/config/app.config.test.ts

@@ -5,7 +5,6 @@
  * - Plugin configuration
  * - Build settings
  * - Configuration structure
- * - Firebase configuration via environment variables
  */
 
 import appConfig from '../../app.config';
@@ -135,76 +134,4 @@ describe('app.config.ts', () => {
       expect(config.updates).toBeDefined();
     });
   });
-
-  describe('Firebase Configuration', () => {
-    describe('iOS googleServicesFile', () => {
-      it('uses environment variable when GOOGLE_SERVICE_INFO_PLIST is set', () => {
-        process.env.GOOGLE_SERVICE_INFO_PLIST = '/tmp/eas-secret/GoogleService-Info.plist';
-
-        const config = appConfig({ config: {} } as any);
-
-        expect(config.ios?.googleServicesFile).toBe('/tmp/eas-secret/GoogleService-Info.plist');
-      });
-
-      it('falls back to local file when GOOGLE_SERVICE_INFO_PLIST is not set', () => {
-        delete process.env.GOOGLE_SERVICE_INFO_PLIST;
-
-        const config = appConfig({ config: {} } as any);
-
-        expect(config.ios?.googleServicesFile).toBe('./GoogleService-Info.plist');
-      });
-
-      it('falls back to local file when GOOGLE_SERVICE_INFO_PLIST is empty string', () => {
-        process.env.GOOGLE_SERVICE_INFO_PLIST = '';
-
-        const config = appConfig({ config: {} } as any);
-
-        // Empty string is falsy, so it should fall back to local file
-        expect(config.ios?.googleServicesFile).toBe('./GoogleService-Info.plist');
-      });
-    });
-
-    describe('Android googleServicesFile', () => {
-      it('uses environment variable when GOOGLE_SERVICES_JSON is set', () => {
-        process.env.GOOGLE_SERVICES_JSON = '/tmp/eas-secret/google-services.json';
-
-        const config = appConfig({ config: {} } as any);
-
-        expect(config.android?.googleServicesFile).toBe('/tmp/eas-secret/google-services.json');
-      });
-
-      it('falls back to local file when GOOGLE_SERVICES_JSON is not set', () => {
-        delete process.env.GOOGLE_SERVICES_JSON;
-
-        const config = appConfig({ config: {} } as any);
-
-        expect(config.android?.googleServicesFile).toBe('./google-services.json');
-      });
-
-      it('falls back to local file when GOOGLE_SERVICES_JSON is empty string', () => {
-        process.env.GOOGLE_SERVICES_JSON = '';
-
-        const config = appConfig({ config: {} } as any);
-
-        // Empty string is falsy, so it should fall back to local file
-        expect(config.android?.googleServicesFile).toBe('./google-services.json');
-      });
-    });
-
-    describe('Firebase plugin configuration', () => {
-      it('includes @react-native-firebase/app plugin', () => {
-        const config = appConfig({ config: {} } as any);
-
-        const hasFirebasePlugin = config.plugins?.includes('@react-native-firebase/app');
-        expect(hasFirebasePlugin).toBe(true);
-      });
-
-      it('includes withModularHeaders plugin for Firebase compatibility', () => {
-        const config = appConfig({ config: {} } as any);
-
-        const hasModularHeadersPlugin = config.plugins?.includes('./plugins/withModularHeaders');
-        expect(hasModularHeadersPlugin).toBe(true);
-      });
-    });
-  });
 });