# DreamLaunch Mobile Stack — Cursor Project Rules
# Stack: React Native + Expo SDK 52 + TypeScript (strict) + NativeWind v4 + Supabase + Expo Router v3

You are an expert React Native developer.
Always use TypeScript with strict mode. Never use 'any'.
Never use class components. Always use functional components with hooks.

## Framework rules
- Use Expo SDK 52. Never use bare React Native unless I ask.
- Use Expo Router v3 for all navigation. No React Navigation.
- File-based routing lives in /app directory.
- Shared components live in /components. Screens live in /app.
- Use NativeWind v4 for all styling. No StyleSheet.create() unless unavoidable.
- Tailwind classes only — no inline style objects for layout.

## Data + auth
- Use Supabase for all database operations.
- Import the Supabase client from @/lib/supabase.
- Always use row-level security. Never expose the service role key client-side.
- Auth state lives in a context at @/context/AuthContext.
- Use Supabase realtime subscriptions for live data — not polling.

## Component conventions
- Component files use PascalCase. Utility files use camelCase.
- Export components as named exports, not default.
- Props interfaces defined above the component, named [ComponentName]Props.
- Use React.memo() for list item components only.
- No prop drilling beyond 2 levels — use context or Zustand.

## State management
- Local UI state: useState.
- Cross-component state: Zustand stores in /store directory.
- Server state: TanStack Query (React Query) with Supabase fetcher.
- Never store auth tokens manually — use Supabase session.

## Payments
- RevenueCat SDK is the only payment handler. Import from react-native-purchases.
- Paywall component lives at @/components/Paywall.tsx.
- Always check entitlement status before showing premium features.
- Never implement custom receipt validation.

## Error handling
- Use Sentry.captureException() for all caught errors in production paths.
- User-facing errors show a toast (via Burnt library), not an alert().
- Never swallow errors silently.

## Performance
- FlashList instead of FlatList for all scrollable lists.
- Images use expo-image, not the built-in Image component.
- Use useMemo and useCallback only when profiling shows it helps.
- Avoid anonymous functions in JSX render paths for list items.

## File generation
When creating a new screen, always include:
1. Types file alongside the screen
2. A loading state
3. An error state
4. A proper KeyboardAvoidingView if the screen has inputs

import { ExpoConfig, ConfigContext } from 'expo/config';

export default ({ config }: ConfigContext): ExpoConfig => ({
  ...config,
  name: 'Your App Name',
  slug: 'your-app-slug',
  version: '1.0.0',
  orientation: 'portrait',
  icon: './assets/icon.png',
  scheme: 'yourapp',          // deep link scheme
  userInterfaceStyle: 'automatic',  // supports dark mode
  splash: {
    image: './assets/splash.png',
    resizeMode: 'contain',
    backgroundColor: '#ffffff',
  },
  ios: {
    supportsTablet: false,
    bundleIdentifier: 'com.yourcompany.yourapp',
    buildNumber: '1',
    infoPlist: {
      NSCameraUsageDescription: 'Used for profile photos',
    },
  },
  android: {
    package: 'com.yourcompany.yourapp',
    versionCode: 1,
    adaptiveIcon: {
      foregroundImage: './assets/adaptive-icon.png',
      backgroundColor: '#ffffff',
    },
    permissions: ['CAMERA', 'READ_EXTERNAL_STORAGE'],
  },
  plugins: [
    'expo-router',
    'expo-notifications',
    ['expo-image-picker', { photosPermission: '...' }],
    ['@sentry/react-native/expo', { organization: '...', project: '...' }],
  ],
  extra: {
    supabaseUrl: process.env.EXPO_PUBLIC_SUPABASE_URL,
    supabaseAnonKey: process.env.EXPO_PUBLIC_SUPABASE_ANON_KEY,
    revenueCatApiKey: process.env.EXPO_PUBLIC_REVENUECAT_KEY,
    eas: { projectId: 'your-eas-project-id' },
  },
});

import { createClient } from '@supabase/supabase-js';
import AsyncStorage from '@react-native-async-storage/async-storage';
import { AppState } from 'react-native';

const supabaseUrl = process.env.EXPO_PUBLIC_SUPABASE_URL!;
const supabaseAnonKey = process.env.EXPO_PUBLIC_SUPABASE_ANON_KEY!;

export const supabase = createClient(supabaseUrl, supabaseAnonKey, {
  auth: {
    storage: AsyncStorage,
    autoRefreshToken: true,
    persistSession: true,
    detectSessionInUrl: false,
  },
});

// Keep session alive when app returns from background
AppState.addEventListener('change', (state) => {
  if (state === 'active') supabase.auth.startAutoRefresh();
  else supabase.auth.stopAutoRefresh();
});

{
  "cli": { "version": ">= 7.0.0" },
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal",
      "env": { "APP_ENV": "development" }
    },
    "preview": {
      "distribution": "internal",
      "env": { "APP_ENV": "preview" },
      "ios": { "simulator": false }
    },
    "production": {
      "autoIncrement": true,
      "env": { "APP_ENV": "production" }
    }
  },
  "submit": {
    "production": {
      "ios": { "appleId": "your@email.com", "ascAppId": "YOUR_APP_ID" },
      "android": { "serviceAccountKeyPath": "./google-play-key.json", "track": "internal" }
    }
  }
}

{
  "scripts": {
    // Dev
    "start":         "expo start",
    "ios":           "expo start --ios",
    "android":       "expo start --android",
    "dev-client":    "expo start --dev-client",

    // Type checks
    "type-check":    "tsc --noEmit",
    "lint":          "eslint . --ext .ts,.tsx --fix",

    // EAS builds
    "build:dev":     "eas build --profile development --platform all",
    "build:preview": "eas build --profile preview --platform all",
    "build:prod":    "eas build --profile production --platform all",
    "build:ios":     "eas build --profile production --platform ios",
    "build:android": "eas build --profile production --platform android",

    // Submissions
    "submit:ios":    "eas submit --platform ios",
    "submit:android":"eas submit --platform android",
    "submit:all":    "eas submit --platform all",

    // Updates (OTA)
    "update":        "eas update --branch production --message",
    "update:staging":"eas update --branch preview",

    // Database
    "db:types":      "supabase gen types typescript --linked > types/supabase.ts",
    "db:push":       "supabase db push",
    "db:reset":      "supabase db reset"
  }
}

# Expo shortcuts
alias es="expo start"
alias ec="expo start --dev-client"
alias ecl="expo start --clear"

# EAS one-liners
alias bp="eas build --profile production --platform all"
alias bios="eas build --profile production --platform ios"
alias band="eas build --profile production --platform android"
alias sub="eas submit --platform all"

# Supabase
alias dbt="supabase gen types typescript --linked > types/supabase.ts"
alias sbstart="supabase start"
alias sbstop="supabase stop"

# OTA push (usage: ota "fix login bug")
ota() { eas update --branch production --message "$1"; }