build_and_development_commands: - npm install # Install dependencies - npx expo start # Start Expo development server - npx expo run:android # Run app on Android device/emulator - npx expo run:ios # Run app on iOS simulator (Mac only) - npx expo build:android # Build Android APK or AAB - npx expo build:ios # Build iOS app (requires Apple Developer account) - npm run lint # Check for linting issues - npm run format # Auto-format code with Prettier

testing_guidelines: - Use jest for unit and component testing - Use @testing-library/react-native for rendering and interaction tests - Run tests with npm run test - Mock async storage, network requests, and native modules when necessary - Ensure all logic-heavy components/functions have test coverage

code_style_and_guidelines: - Use TypeScript for all components and modules - Use functional components and React Hooks - Follow Prettier and ESLint rules (npm run lint && npm run format) - Folder structure: - /components - /screens - /hooks - /utils - /assets - /navigation - Avoid anonymous functions in JSX - Use environment variables securely via expo-constants or dotenv setup with expo-env

documentation_guidelines: - All exported functions/components should use JSDoc - Update the root README.md after major changes - Document any third-party API integrations - Include setup instructions, .env requirements, and build commands - Include screen recordings or screenshots for key UI features