# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Commands
- **Start development server**: `npm start`
- **Run on Android**: `npm run android`
- **Run on iOS**: `npm run ios`
- **Run on Web**: `npm run web`
- **Lint**: `npm run lint`
- **Reset project**: `npm run reset-project`

## Architecture
- **Framework**: React Native (Expo) with TypeScript.
- **Navigation**: Expo Router for file-based routing (`app/` directory).
- **State Management**: Redux Toolkit with slices for different domains (user, training plans, workouts, challenges, etc.).
- **UI**: Themed components (`ThemedText`, `ThemedView`) and reusable UI elements (`Collapsible`, `ParallaxScrollView`).
- **API Layer**: Service files for communicating with backend APIs (`services/` directory).
- **Data Persistence**: AsyncStorage for local data storage.
- **Platform-Specific**: Android (`android/`) and iOS (`ios/`) configurations with native modules.
- **Hooks**: Custom hooks for color scheme (`useColorScheme`), theme management (`useThemeColor`), and Redux integration (`useRedux`).
- **Dependencies**: React Navigation for tab-based navigation, Expo modules for native features (haptics, blur, image picking, etc.), and third-party libraries for specific functionality.

## Key Features
- **Authentication**: Login flow with Apple authentication support.
- **Training Plans**: Creation and management of personalized pilates training plans.
- **Workouts**: Daily workout tracking and session management.
- **AI Features**: AI coach chat and posture assessment capabilities.
- **Health Integration**: Integration with health data tracking.
- **Content Management**: Article reading and educational content.
- **Challenge System**: Challenge participation and progress tracking.
- **User Profiles**: Personal information management and goal setting.

## Directory Structure
- `app/`: Main application screens and routing
- `components/`: Reusable UI components
- `constants/`: Application constants and configuration
- `hooks/`: Custom React hooks
- `services/`: API service layer
- `store/`: Redux store and slices
- `types/`: TypeScript type definitions