ai-flow-dev 2.1.3 → 2.1.5

package/prompts/mobile/flow-build-phase-1.md

@@ -3,9 +3,7 @@
 **Duration:** 20-25 minutes
 **Questions:** ~15 questions
 **Output:** project-brief.md, parts of AGENT.md, parts of ai-instructions.md
-
----
-
+---
 ## 🎯 Objective
 
 Determine the **technical foundation** for your mobile application:
@@ -14,9 +12,7 @@ Determine the **technical foundation** for your mobile application:
 2. What framework will you use?
 3. What minimum OS versions will you support?
 4. What development tools and languages?
-
----
-
+---
 ## 📋 Questions
 
 ### Question 1.1: Target Platforms
@@ -24,46 +20,51 @@ Determine the **technical foundation** for your mobile application:
 **What platforms will your app support?**
 
 A) ⭐ **iOS Only**
-   - Apple App Store only
-   - Swift or React Native iOS
-   - Best for: Apple-focused products, faster initial launch
+
+- Apple App Store only
+- Swift or React Native iOS
+- Best for: Apple-focused products, faster initial launch
 
 B) ⭐ **Android Only**
-   - Google Play Store only
-   - Kotlin or React Native Android
-   - Best for: Android-focused products, wider market reach
+
+- Google Play Store only
+- Kotlin or React Native Android
+- Best for: Android-focused products, wider market reach
 
 C) 🔥 **iOS + Android (Cross-Platform)** (Recommended)
-   - Both App Store and Play Store
-   - React Native, Flutter, or Ionic
-   - Best for: Maximum reach, shared codebase
 
-D) **iOS + Android + Web (Universal)**
-   - Mobile apps + web version
-   - React Native Web, Flutter Web, or PWA
-   - Best for: Multi-platform presence
+- Both App Store and Play Store
+- React Native, Flutter, or Ionic
+- Best for: Maximum reach, shared codebase
 
-**Your answer:**
+D) **iOS + Android + Web (Universal)**
 
----
+- Mobile apps + web version
+- React Native Web, Flutter Web, or PWA
+- Best for: Multi-platform presence
 
+**Your answer:**
+---
 ### Question 1.2: Mobile Framework
 
 **What framework will you use to build your mobile app?**
 
 **If iOS Only:**
+
 - A) ⭐ **Native iOS (Swift)** - Best performance, full native features
 - B) **Native iOS (Objective-C)** - Legacy support
 - C) **React Native** - Cross-platform, JavaScript
 - D) **Flutter** - Cross-platform, Dart
 
 **If Android Only:**
+
 - A) ⭐ **Native Android (Kotlin)** - Best performance, full native features
 - B) **Native Android (Java)** - Legacy support
 - C) **React Native** - Cross-platform, JavaScript
 - D) **Flutter** - Cross-platform, Dart
 
 **If Cross-Platform:**
+
 - A) ⭐ **React Native** (Recommended)
   - JavaScript/TypeScript
   - Large ecosystem
@@ -89,22 +90,23 @@ D) **iOS + Android + Web (Universal)**
 **Your answer:**
 
 **If React Native selected, ask:**
+
 - What React Native version? (Latest stable recommended)
 - Will you use Expo? (Y/n)
   - Expo: Faster development, managed workflow
   - Bare React Native: More control, custom native code
 
 **If Flutter selected, ask:**
+
 - What Flutter version? (Latest stable recommended)
 - Will you use Flutter for Web/Desktop too? (Y/n)
-
----
-
+---
 ### Question 1.3: Minimum OS Versions
 
 **What minimum OS versions will you support?**
 
 **For iOS:**
+
 - A) ⭐ **iOS 15+** (Recommended)
   - Covers ~95% of active devices
   - Modern APIs available
@@ -126,6 +128,7 @@ D) **iOS + Android + Web (Universal)**
   - Best for: Premium apps, latest tech
 
 **For Android:**
+
 - A) ⭐ **Android 8.0 (API 26)+** (Recommended)
   - Covers ~95% of active devices
   - Modern APIs available
@@ -147,14 +150,13 @@ D) **iOS + Android + Web (Universal)**
   - Best for: Premium apps, latest tech
 
 **Your answer:**
-
----
-
+---
 ### Question 1.4: Programming Language
 
 **What programming language will you use?**
 
 **If React Native:**
+
 - A) ⭐ **TypeScript** (Recommended)
   - Type safety
   - Better IDE support
@@ -166,9 +168,11 @@ D) **iOS + Android + Web (Universal)**
   - Best for: Small projects, rapid prototyping
 
 **If Flutter:**
+
 - **Dart** (Required - Flutter uses Dart)
 
 **If Native iOS:**
+
 - A) ⭐ **Swift** (Recommended)
   - Modern, safe language
   - Apple's preferred language
@@ -178,6 +182,7 @@ D) **iOS + Android + Web (Universal)**
   - Best for: Maintaining existing apps
 
 **If Native Android:**
+
 - A) ⭐ **Kotlin** (Recommended)
   - Modern, concise language
   - Google's preferred language
@@ -187,93 +192,99 @@ D) **iOS + Android + Web (Universal)**
   - Best for: Maintaining existing apps
 
 **Your answer:**
-
----
-
+---
 ### Question 1.5: Development Environment
 
 **What development tools will you use?**
 
 **For iOS Development:**
+
 - A) ⭐ **Xcode** (Required for iOS)
   - Version: Latest stable (15.x)
   - Includes iOS Simulator
   - Interface Builder, Instruments
 
 **For Android Development:**
+
 - A) ⭐ **Android Studio** (Required for Android)
   - Version: Latest stable
   - Includes Android Emulator
   - Gradle build system
 
 **For Cross-Platform:**
+
 - **VS Code** or **Android Studio** / **Xcode** (for native modules)
 
 **Additional Tools:**
+
 - **Flipper** - Debugging tool (React Native)
 - **React Native Debugger** - Debugging (React Native)
 - **Dart DevTools** - Debugging (Flutter)
 
 **Your answer:**
-
----
-
+---
 ### Question 1.6: Package Manager
 
 **What package manager will you use?**
 
 **If React Native:**
+
 - A) ⭐ **npm** (Recommended)
 - B) **yarn**
 - C) **pnpm**
 
 **If Flutter:**
+
 - **pub** (Flutter's built-in package manager)
 
 **If Native iOS:**
+
 - **CocoaPods** or **Swift Package Manager**
 
 **If Native Android:**
+
 - **Gradle** (built-in)
 
 **Your answer:**
-
----
-
+---
 ### Question 1.7: Build Tools & CI/CD
 
 **What build and deployment tools will you use?**
 
 A) ⭐ **Fastlane** (Recommended for iOS/Android)
-   - Automates builds, screenshots, deployment
-   - Works with React Native, Flutter, Native
-   - Best for: Most projects
+
+- Automates builds, screenshots, deployment
+- Works with React Native, Flutter, Native
+- Best for: Most projects
 
 B) **Codemagic**
-   - Cloud-based CI/CD for Flutter/React Native
-   - Easy setup, good for small teams
+
+- Cloud-based CI/CD for Flutter/React Native
+- Easy setup, good for small teams
 
 C) **GitHub Actions**
-   - Flexible, free for public repos
-   - Custom workflows
+
+- Flexible, free for public repos
+- Custom workflows
 
 D) **Bitrise**
-   - Mobile-focused CI/CD
-   - Good for complex workflows
 
-E) **Manual Builds**
-   - Build locally, upload manually
-   - Best for: Learning, small projects
+- Mobile-focused CI/CD
+- Good for complex workflows
 
-**Your answer:**
+E) **Manual Builds**
 
----
+- Build locally, upload manually
+- Best for: Learning, small projects
 
+**Your answer:**
+---
 ### Question 1.8: Code Signing Strategy
 
 **How will you handle code signing?**
 
 **For iOS:**
+
 - A) ⭐ **Automatic Signing** (Recommended)
   - Xcode manages certificates
   - Easier for most developers
@@ -283,6 +294,7 @@ E) **Manual Builds**
   - Required for enterprise apps
 
 **For Android:**
+
 - A) ⭐ **Automatic Signing** (Recommended)
   - Gradle manages keystores
   - Easier for most developers
@@ -292,80 +304,83 @@ E) **Manual Builds**
   - Required for some enterprise scenarios
 
 **Your answer:**
-
----
-
+---
 ### Question 1.9: App Store Accounts
 
 **Do you have App Store accounts set up?**
 
 **For iOS:**
+
 - A) ✅ **Yes, Apple Developer Account** ($99/year)
 - B) ❌ **No, will set up later**
 - C) **Enterprise Account** ($299/year)
 
 **For Android:**
+
 - A) ✅ **Yes, Google Play Developer Account** ($25 one-time)
 - B) ❌ **No, will set up later**
 
 **Your answer:**
-
----
-
+---
 ### Question 1.10: Beta Testing Strategy
 
 **How will you handle beta testing?**
 
 A) ⭐ **TestFlight (iOS) + Firebase App Distribution (Android)**
-   - Free, easy to use
-   - Best for: Most projects
+
+- Free, easy to use
+- Best for: Most projects
 
 B) **TestFlight (iOS) + Google Play Internal Testing (Android)**
-   - Official store channels
-   - Best for: Store-focused testing
+
+- Official store channels
+- Best for: Store-focused testing
 
 C) **HockeyApp / App Center**
-   - Microsoft's solution
-   - Good for enterprise
 
-D) **No Beta Testing**
-   - Direct to production
-   - Best for: MVPs, internal apps
+- Microsoft's solution
+- Good for enterprise
 
-**Your answer:**
+D) **No Beta Testing**
 
----
+- Direct to production
+- Best for: MVPs, internal apps
 
+**Your answer:**
+---
 ### Question 1.11: Analytics & Crash Reporting
 
 **What analytics and crash reporting will you use?**
 
 A) ⭐ **Firebase Analytics + Crashlytics** (Recommended)
-   - Free, comprehensive
-   - Works with iOS and Android
-   - Best for: Most projects
+
+- Free, comprehensive
+- Works with iOS and Android
+- Best for: Most projects
 
 B) **Sentry**
-   - Excellent error tracking
-   - Good for: Production apps
+
+- Excellent error tracking
+- Good for: Production apps
 
 C) **Mixpanel / Amplitude**
-   - Advanced analytics
-   - Best for: Product analytics focus
 
-D) **No Analytics**
-   - Privacy-focused
-   - Best for: Privacy-critical apps
+- Advanced analytics
+- Best for: Product analytics focus
 
-**Your answer:**
+D) **No Analytics**
 
----
+- Privacy-focused
+- Best for: Privacy-critical apps
 
+**Your answer:**
+---
 ### Question 1.12: UI/UX Framework
 
 **What UI/UX framework or design system will you use?**
 
 **If React Native:**
+
 - A) ⭐ **React Native Paper** (Material Design)
   - Material Design components
   - Best for: Android-first apps
@@ -380,6 +395,7 @@ D) **No Analytics**
   - Best for: Brand-specific design
 
 **If Flutter:**
+
 - A) ⭐ **Material Design 3** (Default)
   - Google's Material Design
   - Best for: Most apps
@@ -391,103 +407,108 @@ D) **No Analytics**
   - Best for: Brand-specific design
 
 **If Native iOS:**
+
 - A) ⭐ **UIKit** (Standard)
 - B) **SwiftUI** (Modern)
 
 **If Native Android:**
+
 - A) ⭐ **Material Design Components**
 - B) **Jetpack Compose**
 
 **Your answer:**
 
 **If cross-platform, ask:**
+
 - Will you use platform-specific UI? (iOS uses Cupertino, Android uses Material)
 - Or unified design across platforms?
-
----
-
+---
 ### Question 1.13: Theme & Dark Mode
 
 **Will your app support dark mode?**
 
 A) ⭐ **Yes - System Theme** (Recommended)
-   - Follows system dark/light mode
-   - Best for: Most apps
+
+- Follows system dark/light mode
+- Best for: Most apps
 
 B) **Yes - Manual Toggle**
-   - User can toggle dark/light mode
-   - Best for: Apps with theme customization
 
-C) **No Dark Mode**
-   - Light mode only
-   - Best for: Simple apps
+- User can toggle dark/light mode
+- Best for: Apps with theme customization
 
-**Your answer:**
+C) **No Dark Mode**
 
----
+- Light mode only
+- Best for: Simple apps
 
+**Your answer:**
+---
 ### Question 1.14: Internationalization (i18n)
 
 **Will your app support multiple languages?**
 
 A) ⭐ **Yes - Multiple Languages** (Recommended)
-   - Support 2+ languages
-   - Best for: Global apps
+
+- Support 2+ languages
+- Best for: Global apps
 
 B) **Yes - English Only (for now)**
-   - Single language, but i18n-ready
-   - Best for: MVPs planning expansion
+
+- Single language, but i18n-ready
+- Best for: MVPs planning expansion
 
 C) **No Internationalization**
-   - Single language only
-   - Best for: Local apps
+
+- Single language only
+- Best for: Local apps
 
 **Your answer:**
 
 **If multiple languages selected, ask:**
+
 - What i18n library?
   - React Native: react-i18next, react-native-localize
   - Flutter: intl, easy_localization
   - Native: NSLocalizedString (iOS), Resources (Android)
-
----
-
+---
 ### Question 1.15: Image & Asset Management
 
 **How will you handle images and assets?**
 
 A) ⭐ **Local Assets + Remote Images** (Recommended)
-   - Local assets for icons/logos
-   - Remote images for content
-   - Best for: Most apps
+
+- Local assets for icons/logos
+- Remote images for content
+- Best for: Most apps
 
 B) **All Local Assets**
-   - All images bundled with app
-   - Best for: Small apps, offline-first
+
+- All images bundled with app
+- Best for: Small apps, offline-first
 
 C) **All Remote Images**
-   - All images from CDN/server
-   - Best for: Content-heavy apps
+
+- All images from CDN/server
+- Best for: Content-heavy apps
 
 **Your answer:**
 
 **If remote images selected, ask:**
+
 - What image optimization library?
   - React Native: react-native-fast-image, react-native-image-caching
   - Flutter: cached_network_image
   - Native: SDWebImage (iOS), Glide (Android)
-
----
-
+---
 ## ✅ Phase 1 Completion
 
 After answering all questions, summarize:
 
 ```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+---
 ✅ Phase 1 Complete: Platform & Framework Selection
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
+---
 Selected Stack:
 - Platforms: iOS + Android
 - Framework: React Native 0.72.0
@@ -504,9 +525,7 @@ Selected Stack:
 
 Proceed to Phase 2 (Navigation & Architecture)? (Y/n)
 ```
-
----
-
+---
 ## 📝 Generated Documents
 
 After Phase 1, generate/update:
@@ -514,15 +533,11 @@ After Phase 1, generate/update:
 - `project-brief.md` - Add platform and framework information
 - `AGENT.md` - Update technical context section
 - `ai-instructions.md` - Add framework-specific rules and setup
-
----
-
+---
 **Next Phase:** Phase 2 - Navigation & Architecture
 
 Read: `.ai-flow/prompts/mobile/flow-build-phase-2-navigation.md`
-
----
-
+---
 **Last Updated:** 2025-01-XX
 
 **Version:** 1.4.0