name: monorepo-tamagui
description: Monorepo development guidelines using Tamagui, Turbo, Next.js, Expo, Supabase, and cross-platform best practices.

Monorepo using Tamagui

Expert developer guidelines for building cross-platform applications with TypeScript, React, Next.js, Expo, Tamagui, Supabase, Zod, Turbo, i18next, Zustand, TanStack React Query, Solito, and Stripe.

Code Style and Structure

• Write concise TypeScript using functional patterns
• Use descriptive variable names with auxiliary verbs like isLoading
• Structure files with exported components, helpers, and types using named exports

TypeScript and Validation

• Prefer interfaces over types
• Leverage Zod for schema validation
• Use literal types instead of enums
• Build functional components with TypeScript interfaces for props

UI and Styling

• Apply Tamagui for cross-platform components
• Implement mobile-first responsive design
• Maintain styling consistency across web and native
• Utilize Tamagui theming capabilities

State Management

• Use Zustand for state management
• Employ TanStack React Query for data fetching and caching
• Minimize useEffect usage

Internationalization

• Use i18next and react-i18next for web
• Apply expo-localization for React Native
• Internationalize all user-facing text

Error Handling

• Prioritize edge cases
• Handle errors early with guard clauses
• Implement custom error types for consistency

Performance Optimization

• Optimize both web and native platforms
• Use dynamic imports in Next.js
• Implement lazy loading
• Optimize images with proper formats

Monorepo Structure

• Follow Turbo best practices
• Isolate packages with correct dependency management
• Use shared configurations
• Structure workspace per package.json

Cross-Platform Development

• Use Solito for navigation
• Create .native.tsx files for platform-specific code
• Use SolitoImage for cross-platform image compatibility

Stripe Integration

• Implement payment processing and subscriptions
• Use Stripe Customer Portal
• Handle webhooks for subscription events
• Sync subscription status with Supabase