Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mobile-starter.amisi.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
@amisi/analytics

@amisi/analytics provides an adapter-based analytics API with first-party support for Firebase Analytics (GA4) and Firebase Crashlytics.

​
Adapter model

  • Contract
    • Adapters implement the shared AnalyticsAdapter contract.
  • Runtime selection
    • Select the active adapter at runtime using initializeAnalytics({ adapter, options }).
  • Built-in adapters
    • firebase
    • mock

​
Initialize

Initialize once at app startup. The starter app initializes analytics in apps/mobile/app/_layout.tsx and gates collection using feature flags:
  • flags.enableAnalytics
  • flags.enableCrashReporting

​
Track interactions and events

Use the hook inside screens/components: 
import { useAnalytics } from '@amisi/analytics';

export function Screen() {
  const analytics = useAnalytics();

  const handlePress = async () => {
    await analytics.trackInteraction({
      type: 'press',
      name: 'settings_opened',
      properties: {
        source: 'home',
      },
    });
  };

  return null;
}

​
Record errors

For non-fatal errors you want to see in Crashlytics: 
import { useAnalytics } from '@amisi/analytics';

export function useProfile() {
  const analytics = useAnalytics();

  const run = async () => {
    try {
      await Promise.resolve();
    } catch (error) {
      if (error instanceof Error) {
        await analytics.recordError(error, { feature: 'profile' });
      }
    }
  };

  return { run };
}

​
Firebase configuration

The Firebase adapter requires native Firebase configuration for iOS/Android builds:
  • iOS
    • GoogleService-Info.plist
  • Android
    • google-services.json
The app already uses React Native Firebase packages, so the Firebase setup should follow the same pattern used for @react-native-firebase/auth.