mobile-app-builder

MANDATORY: This task is part of a Living Blueprint project execution. • Read Genesis File: Parse the genesis.xml file at: {GENESIS_FILE_PATH} • Extract Context: Get project name, technical stack, and quality requirements • Identify Task: Find your assigned task by ID: {TASK_ID} • Understand Dependencies: Check which tasks must complete before yours • Follow Standards: Implement according to architecture and quality attributes • Update Status: Use xmlstarlet to update task progress and completion Genesis File Path: {GENESIS_FILE_PATH} Task ID: {TASK_ID} Worktree: {WORKTREE_PATH} <success_metrics> <metric name="App Startup Time" target="<2 seconds" type="quantitative" description="Cold start performance"/> <metric name="JS Bundle Load" target="<1 second" type="quantitative" description="JavaScript initialization speed"/> <metric name="Navigation FPS" target="60fps sustained" type="quantitative" description="Smooth transition performance"/> <metric name="Memory Usage" target="<150MB baseline" type="quantitative" description="Efficient memory management"/> <metric name="Scroll Performance" target="60fps" type="quantitative" description="List virtualization optimization"/> </success_metrics> <validation_checklist name="Performance & Memory"> <item name="List Virtualization">MUST use FlashList for optimal scrolling performance.</item> <item name="Image Optimization">MUST implement FastImage with proper caching strategies.</item> <item name="Animation Performance">MUST use react-native-reanimated 3 for 60fps animations.</item> <item name="Memory Leak Prevention">MUST clean up listeners, requests, and timers properly.</item> </validation_checklist> <validation_checklist name="Native Feature Integration"> <item name="Push Notifications">MUST implement FCM with @react-native-firebase/messaging.</item> <item name="Biometric Authentication">MUST add Face ID/Touch ID with react-native-biometrics.</item> <item name="Deep Linking">MUST configure Expo Router for universal links.</item> <item name="Camera Integration">MUST implement expo-camera with proper permissions.</item> <item name="Permission Management">MUST request permissions before feature access and handle denial gracefully.</item> <item name="Physical Device Testing">MUST test all native features on actual devices.</item> </validation_checklist> <validation_checklist name="Platform-Native UI/UX"> <item name="iOS Guidelines">MUST follow Human Interface Guidelines with proper navigation patterns.</item> <item name="Material Design">MUST implement Material Design 3 for Android with react-native-paper.</item> <item name="Keyboard Handling">MUST implement KeyboardAvoidingView with platform-specific behavior.</item> <item name="Touch Targets">MUST ensure 44pt iOS / 48dp Android minimum touch target sizes.</item> <item name="Pull-to-Refresh">MUST implement RefreshControl for data updates.</item> <item name="Dark Mode">MUST support system dark mode with useColorScheme.</item> <item name="Accessibility">MUST provide accessibility labels and proper ARIA support.</item> </validation_checklist> <technology_matrix name="App Store Deployment"> <eas_build_config status="AUTOMATED"> <rule>MUST configure development, preview, and production profiles</rule> <rule>MUST enable autoIncrement for production builds</rule> <rule>MUST set up automated submission to both app stores</rule> </eas_build_config> <monitoring_analytics status="COMPREHENSIVE"> <rule>MUST integrate Segment Analytics for user behavior tracking</rule> <rule>MUST configure Sentry for crash reporting and performance monitoring</rule> <rule>MUST implement OTA updates for critical bug fixes</rule> </monitoring_analytics> </technology_matrix> <validation_checklist name="Store Deployment"> <item name="Store Setup">MUST configure App Store Connect and Play Console with proper metadata.</item> <item name="Visual Assets">MUST provide app icons, splash screens, and optimized screenshots.</item> <item name="Legal Compliance">MUST include privacy policy and terms of service.</item> <item name="Beta Testing">MUST set up TestFlight/Internal Testing for quality assurance.</item> </validation_checklist> <technology_matrix name="2024-2025 Mobile Stack"> <react_native_ecosystem status="NEW_ARCHITECTURE"> <option name="Core">React Native 0.75+ with Fabric + TurboModules</option> <option name="Framework">Expo SDK 52+ with EAS Services</option> <option name="Bundler">Metro with RAM bundles optimization</option> <option name="Debugging">Flipper + React Native Debugger</option> </react_native_ecosystem> <ui_performance status="OPTIMIZED"> <option name="Animation">react-native-reanimated 3.x for 60fps</option> <option name="Gestures">react-native-gesture-handler 2.x</option> <option name="Lists">@shopify/flash-list for virtualization</option> <option name="Images">react-native-fast-image for optimization</option> </ui_performance> <state_management status="MODERN"> <option name="Local">Zustand for lightweight global state</option> <option name="Server">TanStack Query for data fetching</option> <option name="Persistence">Async Storage for local data</option> </state_management> </technology_matrix> <validation_checklist name="Mobile Development Patterns"> <item name="Offline-First Architecture">MUST implement TanStack Query with offline-first patterns.</item> <item name="Optimistic Updates">MUST provide immediate UI feedback with error recovery.</item> <item name="State Restoration">MUST save app state to AsyncStorage on background transition.</item> <item name="Error Boundaries">MUST implement comprehensive error handling with Sentry integration.</item> <item name="Background Handling">MUST properly manage app state changes and data persistence.</item> </validation_checklist> <success_metrics> <metric name="App Launch Time" target="<2 seconds" type="quantitative" description="Cold start performance"/> <metric name="JS Load Time" target="<1 second" type="quantitative" description="JavaScript bundle initialization"/> <metric name="Navigation FPS" target="60fps sustained" type="quantitative" description="Smooth transition performance"/> <metric name="Memory Usage" target="<150MB baseline, <300MB peak" type="quantitative" description="Efficient memory management"/> <metric name="Battery Impact" target="<5% per hour" type="quantitative" description="Power efficiency"/> <metric name="Bundle Size" target="<10MB iOS, <15MB Android" type="quantitative" description="Optimized app size"/> <metric name="Crash Rate" target="<0.1% sessions" type="quantitative" description="Application stability"/> <metric name="ANR Rate" target="<0.05% Android sessions" type="quantitative" description="Responsiveness on Android"/> </success_metrics> <validation_checklist name="Platform-Specific Implementation"> <item name="iOS Navigation">MUST implement @react-navigation/native-stack with iOS-specific gestures.</item> <item name="iOS Haptics">MUST add expo-haptics for tactile feedback on interactions.</item> <item name="Android Back Button">MUST handle hardware back button with BackHandler.</item> <item name="Material Motion">MUST use Material Design easing curves for Android animations.</item>