ai-flow-dev 1.0.1

package/templates/mobile/docs/native-features.template.md

@@ -0,0 +1,137 @@
+# Native Features Guide
+
+> Native features integration for {{PROJECT_NAME}}
+
+---
+
+## 📱 Native Features Overview
+
+**Framework:** {{FRAMEWORK}}
+
+**Native Modules:** {{NATIVE_MODULES_LIST}}
+
+**Third-Party SDKs:** {{THIRD_PARTY_SDKS_LIST}}
+
+---
+
+## 🔐 Permissions
+
+**Required Permissions:**
+{{PERMISSIONS_LIST}}
+
+**Permission Handling:**
+{{PERMISSION_HANDLING_DESCRIPTION}}
+
+---
+
+## 📷 Camera
+
+**Library:** {{CAMERA_LIBRARY}}
+
+**Usage:**
+{{CAMERA_USAGE_DESCRIPTION}}
+
+---
+
+## 📍 Location
+
+**Library:** {{LOCATION_LIBRARY}}
+
+**Usage:**
+{{LOCATION_USAGE_DESCRIPTION}}
+
+---
+
+## 🔔 Push Notifications
+
+**Service:** {{PUSH_NOTIFICATION_SERVICE}}
+
+**Setup:**
+{{PUSH_NOTIFICATION_SETUP}}
+
+---
+
+## 🔐 Biometric Authentication
+
+**Library:** {{BIOMETRIC_LIBRARY}}
+
+**Usage:**
+{{BIOMETRIC_USAGE_DESCRIPTION}}
+
+---
+
+## 📁 File System
+
+**Library:** {{FILE_SYSTEM_LIBRARY}}
+
+**Usage:**
+{{FILE_SYSTEM_USAGE_DESCRIPTION}}
+
+---
+
+## 📞 Contacts
+
+**Library:** {{CONTACTS_LIBRARY}}
+
+**Usage:**
+{{CONTACTS_USAGE_DESCRIPTION}}
+
+---
+
+## 🗺️ Maps
+
+**Library:** {{MAPS_LIBRARY}}
+
+**Usage:**
+{{MAPS_USAGE_DESCRIPTION}}
+
+---
+
+## 💳 Payments
+
+**Library:** {{PAYMENTS_LIBRARY}}
+
+**Usage:**
+{{PAYMENTS_USAGE_DESCRIPTION}}
+
+---
+
+## 🔗 Deep Linking
+
+**Strategy:** {{DEEP_LINKING_STRATEGY}}
+
+**Implementation:**
+{{DEEP_LINKING_IMPLEMENTATION}}
+
+---
+
+## 📊 Analytics
+
+**Service:** {{ANALYTICS_SERVICE}}
+
+**Setup:**
+{{ANALYTICS_SETUP}}
+
+---
+
+## 🐛 Crash Reporting
+
+**Service:** {{CRASH_REPORTING_SERVICE}}
+
+**Setup:**
+{{CRASH_REPORTING_SETUP}}
+
+---
+
+## ✅ Best Practices
+
+1. **Request Permissions Just-In-Time** - Explain why needed
+2. **Handle Permission Denial** - Gracefully handle denial
+3. **Test Native Features** - Test on real devices
+4. **Handle Platform Differences** - iOS vs Android
+5. **Monitor Native Module Performance** - Watch for memory leaks
+
+---
+
+**Last Updated:** {{LAST_UPDATED}}
+

package/templates/mobile/docs/navigation.template.md

@@ -0,0 +1,81 @@
+# Navigation Guide
+
+> Navigation patterns and setup for {{PROJECT_NAME}}
+
+---
+
+## 🧭 Navigation Overview
+
+**Navigation Library:** {{NAVIGATION_LIBRARY}}
+
+**Navigation Pattern:** {{NAVIGATION_PATTERN}}
+
+**Deep Linking Strategy:** {{DEEP_LINKING_STRATEGY}}
+
+---
+
+## 📱 Navigation Structure
+
+{{NAVIGATION_STRUCTURE_DESCRIPTION}}
+
+### Navigation Hierarchy
+
+```
+{{NAVIGATION_HIERARCHY}}
+```
+
+---
+
+## 🔗 Deep Linking
+
+**URL Scheme:** {{URL_SCHEME}}
+
+**Universal Links (iOS):** {{UNIVERSAL_LINKS_ENABLED}}
+
+**App Links (Android):** {{APP_LINKS_ENABLED}}
+
+### Supported Deep Links
+
+{{DEEP_LINKS_LIST}}
+
+### Implementation
+
+{{DEEP_LINKING_IMPLEMENTATION}}
+
+---
+
+## 🎨 Screen Transitions
+
+**Transition Style:** {{TRANSITION_STYLE}}
+
+{{TRANSITION_DESCRIPTION}}
+
+---
+
+## 🔐 Protected Routes
+
+**Authentication Flow:** {{AUTH_FLOW_DESCRIPTION}}
+
+**Protected Screens:**
+{{PROTECTED_SCREENS_LIST}}
+
+---
+
+## 📚 Navigation Best Practices
+
+1. **Consistent Navigation** - Use consistent navigation patterns throughout the app
+2. **Clear Hierarchy** - Maintain clear navigation hierarchy
+3. **Back Button Handling** - Handle back button appropriately on Android
+4. **Deep Links** - Support deep linking for key screens
+5. **State Preservation** - Preserve navigation state when app backgrounds
+
+---
+
+## 🛠️ Implementation Examples
+
+{{NAVIGATION_EXAMPLES}}
+
+---
+
+**Last Updated:** {{LAST_UPDATED}}
+

package/templates/mobile/docs/offline-strategy.template.md

@@ -0,0 +1,90 @@
+# Offline Strategy
+
+> Offline and data synchronization strategy for {{PROJECT_NAME}}
+
+---
+
+## 📡 Offline Overview
+
+**Offline Strategy:** {{OFFLINE_STRATEGY}}
+
+**Storage Solution:** {{STORAGE_SOLUTION}}
+
+**Sync Strategy:** {{SYNC_STRATEGY}}
+
+**Conflict Resolution:** {{CONFLICT_RESOLUTION}}
+
+---
+
+## 💾 Local Storage
+
+**Storage Solution:** {{STORAGE_SOLUTION}}
+
+**Storage Structure:**
+{{STORAGE_STRUCTURE_DESCRIPTION}}
+
+---
+
+## 🔄 Data Synchronization
+
+**Sync Strategy:** {{SYNC_STRATEGY}}
+
+**Sync Flow:**
+{{SYNC_FLOW_DESCRIPTION}}
+
+### Optimistic Updates
+
+{{OPTIMISTIC_UPDATES_DESCRIPTION}}
+
+### Background Sync
+
+{{BACKGROUND_SYNC_DESCRIPTION}}
+
+---
+
+## ⚔️ Conflict Resolution
+
+**Strategy:** {{CONFLICT_RESOLUTION_STRATEGY}}
+
+{{CONFLICT_RESOLUTION_DESCRIPTION}}
+
+---
+
+## 📊 Caching Strategy
+
+**Cache Strategy:** {{CACHE_STRATEGY}}
+
+**Cache Duration:** {{CACHE_DURATION}}
+
+**Cache Invalidation:** {{CACHE_INVALIDATION}}
+
+---
+
+## 🔌 Network Handling
+
+**Network Detection:** {{NETWORK_DETECTION}}
+
+**Offline Indicators:** {{OFFLINE_INDICATORS}}
+
+**Retry Strategy:** {{RETRY_STRATEGY}}
+
+---
+
+## 🛠️ Implementation
+
+{{OFFLINE_IMPLEMENTATION}}
+
+---
+
+## ✅ Best Practices
+
+1. **Cache Critical Data** - Cache data needed for offline functionality
+2. **Show Offline State** - Clearly indicate when app is offline
+3. **Queue Updates** - Queue writes for when connection is restored
+4. **Handle Conflicts** - Implement conflict resolution strategy
+5. **Test Offline Scenarios** - Test all offline flows
+
+---
+
+**Last Updated:** {{LAST_UPDATED}}
+

package/templates/mobile/docs/permissions.template.md

@@ -0,0 +1,70 @@
+# Permissions Guide
+
+> Permission handling for {{PROJECT_NAME}}
+
+---
+
+## 🔐 Permissions Overview
+
+**Permission Request Strategy:** {{PERMISSION_REQUEST_STRATEGY}}
+
+**Permission Denial Handling:** {{PERMISSION_DENIAL_HANDLING}}
+
+---
+
+## 📋 Required Permissions
+
+{{PERMISSIONS_LIST_WITH_DESCRIPTIONS}}
+
+---
+
+## 🎯 Permission Request Flow
+
+### Just-In-Time Requests
+
+{{JUST_IN_TIME_REQUEST_FLOW}}
+
+### Permission Request Examples
+
+{{PERMISSION_REQUEST_EXAMPLES}}
+
+---
+
+## ❌ Handling Denied Permissions
+
+**Strategy:** {{PERMISSION_DENIAL_STRATEGY}}
+
+{{PERMISSION_DENIAL_HANDLING_DESCRIPTION}}
+
+---
+
+## 📱 Platform-Specific Considerations
+
+### iOS
+
+{{IOS_PERMISSIONS_DESCRIPTION}}
+
+### Android
+
+{{ANDROID_PERMISSIONS_DESCRIPTION}}
+
+---
+
+## 🛠️ Implementation
+
+{{PERMISSIONS_IMPLEMENTATION}}
+
+---
+
+## ✅ Best Practices
+
+1. **Request Just-In-Time** - Request permissions when feature is needed
+2. **Explain Why** - Always explain why permission is needed
+3. **Handle Denial** - Gracefully handle permission denial
+4. **Provide Alternatives** - Offer alternatives when permission is denied
+5. **Test Permission Flows** - Test all permission scenarios
+
+---
+
+**Last Updated:** {{LAST_UPDATED}}
+

package/templates/mobile/docs/state-management.template.md

@@ -0,0 +1,116 @@
+# State Management Guide
+
+> State management patterns for {{PROJECT_NAME}}
+
+---
+
+## 🎯 State Management Solution
+
+**Solution:** {{STATE_MANAGEMENT}}
+
+**Storage:** {{STORAGE_SOLUTION}}
+
+**Offline Strategy:** {{OFFLINE_STRATEGY}}
+
+---
+
+## 📊 State Categories
+
+### 1. App State (Global)
+
+**Managed by:** {{STATE_MANAGEMENT}}
+
+**Examples:**
+- User authentication state
+- App theme
+- Global settings
+
+**Pattern:**
+{{APP_STATE_EXAMPLE}}
+
+---
+
+### 2. Server State (Remote Data)
+
+**Managed by:** {{DATA_FETCHING}}
+
+**Examples:**
+- User data from API
+- Product listings
+- Content from backend
+
+**Pattern:**
+{{SERVER_STATE_EXAMPLE}}
+
+---
+
+### 3. Local State (Component State)
+
+**Managed by:** Component state / Hooks
+
+**Examples:**
+- Form inputs
+- Modal open/closed
+- UI flags
+
+**Pattern:**
+{{LOCAL_STATE_EXAMPLE}}
+
+---
+
+### 4. Persistent State (Local Storage)
+
+**Managed by:** {{STORAGE_SOLUTION}}
+
+**Examples:**
+- User preferences
+- Cached data
+- Offline data
+
+**Pattern:**
+{{PERSISTENT_STATE_EXAMPLE}}
+
+---
+
+## 🔄 Data Synchronization
+
+**Sync Strategy:** {{SYNC_STRATEGY}}
+
+{{SYNC_DESCRIPTION}}
+
+---
+
+## 💾 Offline Handling
+
+**Offline Strategy:** {{OFFLINE_STRATEGY}}
+
+{{OFFLINE_HANDLING_DESCRIPTION}}
+
+---
+
+## ⚔️ Conflict Resolution
+
+**Strategy:** {{CONFLICT_RESOLUTION}}
+
+{{CONFLICT_RESOLUTION_DESCRIPTION}}
+
+---
+
+## 🛠️ Implementation Examples
+
+{{STATE_MANAGEMENT_EXAMPLES}}
+
+---
+
+## ✅ Best Practices
+
+1. **Separate Concerns** - Keep app state, server state, and local state separate
+2. **Use Appropriate Tool** - Use right tool for right job
+3. **Handle Offline** - Always handle offline scenarios
+4. **Optimize Performance** - Use memoization and selectors
+5. **Test State Logic** - Write tests for state management logic
+
+---
+
+**Last Updated:** {{LAST_UPDATED}}
+

package/templates/mobile/docs/testing.template.md

@@ -0,0 +1,146 @@
+# Testing Strategy
+
+> Testing approach for {{PROJECT_NAME}}
+
+---
+
+## 🎯 Testing Philosophy
+
+**Goal:** Ship with confidence through comprehensive automated testing
+
+**Principles:**
+1. Test user behavior, not implementation
+2. Write tests that give confidence
+3. Fast feedback loops
+4. Test on real devices
+
+---
+
+## 🏗️ Testing Pyramid
+
+**Distribution:**
+- **70%** Unit Tests
+- **20%** Integration Tests
+- **10%** E2E Tests
+
+---
+
+## 🧪 Testing Stack
+
+**Unit Testing:** {{UNIT_TEST_FRAMEWORK}}
+
+**Component Testing:** {{COMPONENT_TEST_LIBRARY}}
+
+**E2E Testing:** {{E2E_FRAMEWORK}}
+
+**Coverage Target:** {{TEST_COVERAGE_TARGET}}
+
+---
+
+## 📦 Unit Testing
+
+### What to Test
+
+✅ **DO test:**
+- Business logic
+- Utility functions
+- State management logic
+- Custom hooks
+
+❌ **DON'T test:**
+- Third-party libraries
+- Framework internals
+- Trivial code
+
+### Examples
+
+{{UNIT_TEST_EXAMPLES}}
+
+---
+
+## 🧩 Component/Screen Testing
+
+### What to Test
+
+✅ **DO test:**
+- User interactions
+- Component rendering
+- Props handling
+- Event handlers
+
+### Examples
+
+{{COMPONENT_TEST_EXAMPLES}}
+
+---
+
+## 🎭 E2E Testing
+
+### What to Test
+
+✅ **DO test:**
+- Critical user flows
+- Navigation flows
+- Authentication flows
+- Key features
+
+### Examples
+
+{{E2E_TEST_EXAMPLES}}
+
+---
+
+## 📱 Device Testing
+
+**Strategy:** {{DEVICE_TESTING_STRATEGY}}
+
+**Physical Devices:** {{PHYSICAL_DEVICES}}
+
+**Emulators/Simulators:** {{EMULATORS_SIMULATORS}}
+
+---
+
+## 🎨 Snapshot Testing
+
+**Strategy:** {{SNAPSHOT_TESTING_STRATEGY}}
+
+{{SNAPSHOT_TESTING_DESCRIPTION}}
+
+---
+
+## ⚡ Performance Testing
+
+**Strategy:** {{PERFORMANCE_TESTING_STRATEGY}}
+
+{{PERFORMANCE_TESTING_DESCRIPTION}}
+
+---
+
+## ♿ Accessibility Testing
+
+**Strategy:** {{ACCESSIBILITY_TESTING_STRATEGY}}
+
+{{ACCESSIBILITY_TESTING_DESCRIPTION}}
+
+---
+
+## 🔄 CI/CD Integration
+
+**CI/CD Strategy:** {{CICD_TESTING_STRATEGY}}
+
+{{CICD_TESTING_DESCRIPTION}}
+
+---
+
+## ✅ Best Practices
+
+1. **Test on Real Devices** - Not just simulators/emulators
+2. **Test Offline Scenarios** - Handle offline gracefully
+3. **Test Permission Flows** - Test all permission scenarios
+4. **Test Platform Differences** - Test iOS and Android separately
+5. **Maintain Test Coverage** - Keep coverage above target
+
+---
+
+**Last Updated:** {{LAST_UPDATED}}
+

package/templates/mobile/project-brief.template.md

@@ -0,0 +1,97 @@
+# Project Brief: {{PROJECT_NAME}}
+
+> {{PROJECT_DESCRIPTION}}
+
+---
+
+## 📋 Overview
+
+**Project Name:** {{PROJECT_NAME}}
+
+**Description:** {{PROJECT_DESCRIPTION}}
+
+**Problem Statement:** {{PROBLEM_STATEMENT}}
+
+**Target Users:** {{TARGET_USERS}}
+
+**Project Scope:** {{PROJECT_SCOPE}}
+
+---
+
+## 🎯 Objectives
+
+{{OBJECTIVES_LIST}}
+
+---
+
+## 📱 Platform & Framework
+
+**Platforms:** {{PLATFORMS}}
+
+**Framework:** {{FRAMEWORK}} {{FRAMEWORK_VERSION}}
+
+**Language:** {{LANGUAGE}} {{LANGUAGE_VERSION}}
+
+**Minimum OS Versions:**
+- iOS: {{MIN_IOS_VERSION}}
+- Android: {{MIN_ANDROID_VERSION}} (API {{MIN_ANDROID_API}})
+
+---
+
+## 🏗️ Architecture
+
+**Architecture Pattern:** {{ARCHITECTURE_PATTERN}}
+
+**Navigation Pattern:** {{NAVIGATION_PATTERN}}
+
+**Component Organization:** {{COMPONENT_ORGANIZATION}}
+
+**UI Framework:** {{UI_FRAMEWORK}}
+
+**Dark Mode:** {{DARK_MODE_STRATEGY}}
+
+**Internationalization:** {{I18N_STRATEGY}}
+
+---
+
+## 🔑 Key Features
+
+{{KEY_FEATURES_LIST}}
+
+---
+
+## 🔐 Permissions & Native Features
+
+**Required Permissions:**
+{{PERMISSIONS_LIST}}
+
+**Native Features:**
+{{NATIVE_FEATURES_LIST}}
+
+**Third-Party SDKs:**
+{{THIRD_PARTY_SDKS_LIST}}
+
+---
+
+## 📊 Success Metrics
+
+{{SUCCESS_METRICS_LIST}}
+
+---
+
+## 🚀 Timeline
+
+{{TIMELINE_DESCRIPTION}}
+
+---
+
+## 📝 Notes
+
+{{ADDITIONAL_NOTES}}
+
+---
+
+**Created:** {{CREATED_DATE}}
+
+**Last Updated:** {{LAST_UPDATED}}
+