> ## Documentation Index
> Fetch the complete documentation index at: https://mf2.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Mobile

> React Native + Expo mobile app with shared packages.

The `apps/mobile` directory contains a React Native app built with [Expo](https://expo.dev). It shares packages with the web apps so an agent writes a feature once and it runs on both platforms.

## Overview

A cross-platform mobile app that consumes the same backend, auth, analytics, and observability packages as the web apps. One Convex backend serves both web and mobile.

```bash theme={null}
turbo dev:mobile
```

Or directly:

```bash theme={null}
cd apps/mobile && bunx expo start
```

## Features

* **[Authentication](/packages/auth)**: Clerk sign-in, sign-up, and OAuth via `@repo/auth`.
* **[Backend](/packages/convex)**: Real-time data from Convex via `@repo/convex/provider.native`.
* **[Analytics](/packages/analytics)**: PostHog event tracking via `@repo/analytics`.
* **[Observability](/packages/observability)**: Sentry error tracking via `@repo/observability`.
* **[Notifications](/packages/notifications)**: Push notifications via Expo + Knock.
* **In-app purchases**: RevenueCat for Apple and Google subscriptions.

## Styling

The mobile app uses [NativeWind](https://www.nativewind.dev/) with components from `@repo/design-system-native`. These are React Native equivalents of the web design system, generated by [React Native Reusables](https://rnr-docs.vercel.app/).

## Environment variables

Set in `apps/mobile/.env.example`:

| Variable                            | Required | Description               |
| ----------------------------------- | -------- | ------------------------- |
| `EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY` | Yes      | Clerk publishable key     |
| `EXPO_PUBLIC_CONVEX_URL`            | Yes      | Convex deployment URL     |
| `EXPO_PUBLIC_SENTRY_DSN`            | No       | Sentry DSN                |
| `EXPO_PUBLIC_POSTHOG_KEY`           | No       | PostHog project key       |
| `EXPO_PUBLIC_POSTHOG_HOST`          | No       | PostHog host              |
| `EXPO_PUBLIC_REVENUECAT_APPLE_KEY`  | No       | RevenueCat Apple API key  |
| `EXPO_PUBLIC_REVENUECAT_GOOGLE_KEY` | No       | RevenueCat Google API key |