@shaykec/app-agent 1.0.0

package/templates/ios/FinanceTemplate/TESTING_MANIFEST.md

@@ -0,0 +1,171 @@
+# Testing Manifest - FinanceTemplate
+
+This document catalogs all accessibility identifiers added to the FinanceTemplate for automated testing with Maestro and other UI testing frameworks.
+
+## Tab Bar Identifiers
+
+| Tab | Identifier | Icon |
+|-----|------------|------|
+| Home | `tab_bar_home` | house |
+| Transactions | `tab_bar_transactions` | list.bullet |
+| Budgets | `tab_bar_budgets` | chart.pie (conditional) |
+| Goals | `tab_bar_goals` | target (conditional) |
+| More/Settings | `tab_bar_more` | ellipsis |
+
+## HomeView Identifiers
+
+### Buttons
+- `home_add_transaction_button` - Add transaction toolbar button
+- `home_quick_action_add_button` - Quick action: Add
+- `home_quick_action_transfer_button` - Quick action: Transfer
+- `home_quick_action_scan_button` - Quick action: Scan
+- `home_quick_action_reports_button` - Quick action: Reports
+- `home_see_all_accounts_button` - "Add" button in Accounts section
+- `home_see_all_transactions_button` - "See All" link for transactions
+
+### Cards (indexed)
+- `home_account_{index}_card` - Account card (e.g., `home_account_0_card`)
+- `home_transaction_{index}_card` - Recent transaction row (e.g., `home_transaction_0_card`)
+- `home_insight_{index}_card` - Spending insight card (e.g., `home_insight_0_card`)
+
+## TransactionsView Identifiers
+
+### Buttons
+- `transactions_add_button` - Add transaction toolbar button
+- `transactions_edit_button` - Edit button in transaction detail
+- `transactions_delete_button` - Delete button in transaction detail
+
+### Search & Filter
+- `transactions_search_field` - Search field (note: SwiftUI searchable modifier - may require special handling)
+- `transactions_filter_all_chip` - "All" filter pill
+- `transactions_filter_{type}_chip` - Type-specific filter (e.g., `transactions_filter_expense_chip`, `transactions_filter_income_chip`)
+
+### Cards (indexed)
+- `transactions_transaction_{index}_card` - Transaction row in list (e.g., `transactions_transaction_0_card`)
+
+## AddTransactionView Identifiers
+
+### Form Fields
+- `add_transaction_type_picker` - Expense/Income segmented picker
+- `add_transaction_amount_field` - Amount text field
+- `add_transaction_title_field` - Title text field
+- `add_transaction_notes_field` - Notes text field
+- `add_transaction_category_picker` - Category selection button
+- `add_transaction_account_picker` - Account selection button
+- `add_transaction_date_picker` - Date picker
+- `add_transaction_recurring_toggle` - Recurring toggle switch
+
+### Buttons
+- `add_transaction_cancel_button` - Cancel button
+- `add_transaction_save_button` - Save button
+
+## BudgetsView Identifiers
+
+### Buttons
+- `budgets_add_button` - Add budget toolbar button
+- `budgets_cancel_button` - Cancel button in add budget form
+- `budgets_save_button` - Save button in add budget form
+
+### Form Fields
+- `budgets_category_picker` - Category selection (list of buttons)
+- `budgets_limit_field` - Budget limit text field
+- `budgets_period_picker` - Period picker (monthly/weekly/etc)
+- `budgets_alert_toggle` - Alert toggle switch
+
+### Cards (indexed)
+- `budgets_budget_{index}_card` - Budget card (e.g., `budgets_budget_0_card`)
+
+## GoalsView Identifiers
+
+### Buttons
+- `goals_add_button` - Add goal toolbar button
+- `goals_add_amount_button` - "Add to Goal" button in detail view
+- `goals_cancel_button` - Cancel button in add goal form
+- `goals_save_button` - Save button in add goal form
+
+### Form Fields
+- `goals_name_field` - Goal name text field
+- `goals_target_field` - Target amount text field
+- `goals_add_amount_field` - Add funds amount field in detail view
+- `goals_deadline_toggle` - Deadline toggle switch
+- `goals_deadline_picker` - Deadline date picker (shown when toggle is on)
+- `goals_icon_picker` - Icon selection grid
+- `goals_color_picker` - Color selection grid
+
+### Cards (indexed)
+- `goals_goal_{index}_card` - Goal card (e.g., `goals_goal_0_card`)
+
+## SettingsView Identifiers
+
+### Navigation Links
+- `settings_accounts_card` - Accounts navigation link
+- `settings_bills_card` - Bills & Reminders link (conditional)
+- `settings_reports_card` - Reports link
+- `settings_currency_card` - Currency settings link
+- `settings_notifications_card` - Notifications link
+- `settings_security_card` - Security settings link (conditional)
+- `settings_export_card` - Export Data link (conditional)
+- `settings_categories_card` - Categories link
+
+### Buttons
+- `settings_add_account_button` - Add account button in AccountsListView
+
+### Toggles
+- `settings_budget_alerts_toggle` - Budget alerts toggle in NotificationSettingsView
+- `settings_bill_reminders_toggle` - Bill reminders toggle in NotificationSettingsView
+- `settings_goal_progress_toggle` - Goal progress toggle in NotificationSettingsView
+- `settings_biometric_toggle` - Face ID/Touch ID toggle in SecuritySettingsView
+
+### Export Buttons
+- `settings_export_csv_button` - Export as CSV button
+- `settings_export_pdf_button` - Export as PDF button
+
+### Cards (indexed)
+- `settings_account_{index}_card` - Account row in AccountsListView (e.g., `settings_account_0_card`)
+
+## Testing Notes
+
+### Indexed Elements
+All indexed elements use zero-based indexing. For example:
+- First account: `home_account_0_card`
+- Second account: `home_account_1_card`
+- Third transaction: `transactions_transaction_2_card`
+
+### Conditional Elements
+Some elements are only present when feature flags are enabled:
+- Budgets tab: Requires `AppConfig.Features.enableBudgets`
+- Goals tab: Requires `AppConfig.Features.enableGoals`
+- Bills section: Requires `AppConfig.Features.enableBillReminders`
+- Security settings: Requires `AppConfig.Features.enableBiometricAuth`
+- Export options: Requires `AppConfig.Features.enableExport`
+
+### Search Field
+The `transactions_search_field` uses SwiftUI's `.searchable()` modifier, which may require special handling in Maestro. Consider using text-based selectors or accessibility labels if direct ID access doesn't work.
+
+### Dynamic Content
+Some identifiers include dynamic parts (like transaction types in filter chips). Test scripts should account for:
+- Transaction types: `expense`, `income` (filter chips)
+- Variable indices for lists and cards
+
+## Usage in Maestro
+
+Example Maestro test using these identifiers:
+
+```yaml
+appId: ${APP_BUNDLE_ID}
+---
+- launchApp
+- tapOn: "id: tab_bar_home"
+- assertVisible: "id: home_account_0_card"
+- tapOn: "id: home_add_transaction_button"
+- inputText: "100.00", into: "id: add_transaction_amount_field"
+- tapOn: "id: add_transaction_save_button"
+```
+
+## Maintenance
+
+When adding new interactive elements:
+1. Add the identifier to the appropriate section above
+2. Use consistent naming: `{screen}_{element}_{type}`
+3. For indexed elements, document the index pattern
+4. Update this manifest when modifying views

package/templates/ios/FinanceTemplate/project.yml

@@ -0,0 +1,47 @@
+name: FinanceTemplate
+options:
+  bundleIdPrefix: com.appship
+  deploymentTarget:
+    iOS: "17.0"
+  xcodeVersion: "15.0"
+
+settings:
+  base:
+    SWIFT_VERSION: "5.9"
+    MARKETING_VERSION: "1.0"
+    CURRENT_PROJECT_VERSION: "1"
+
+targets:
+  FinanceTemplate:
+    type: application
+    platform: iOS
+    sources:
+      - path: FinanceTemplate
+        excludes:
+          - "**/*.md"
+    settings:
+      base:
+        INFOPLIST_FILE: FinanceTemplate/Resources/Info.plist
+        PRODUCT_BUNDLE_IDENTIFIER: com.appship.finance
+        GENERATE_INFOPLIST_FILE: NO
+  FinanceTemplateTests:
+    type: bundle.unit-test
+    platform: iOS
+    sources:
+      - path: FinanceTemplateTests
+    dependencies:
+      - target: FinanceTemplate
+    settings:
+      base:
+        PRODUCT_BUNDLE_IDENTIFIER: com.appship.finance.tests
+        GENERATE_INFOPLIST_FILE: YES
+
+schemes:
+  FinanceTemplate:
+    build:
+      targets:
+        FinanceTemplate: all
+        FinanceTemplateTests: [test]
+    test:
+      targets:
+        - FinanceTemplateTests

package/templates/ios/FinanceTemplate/tests/01_launch_home.yaml

@@ -0,0 +1,15 @@
+appId: ${APP_BUNDLE_ID}
+---
+- launchApp
+- tapOn:
+    text: "Skip"
+    optional: true
+- tapOn:
+    text: "Get Started"
+    optional: true
+- tapOn:
+    text: "Cancel"
+    optional: true
+- assertVisible: "Overview"
+- assertVisible: ".*Total Balance.*"
+- assertVisible: "Accounts"

package/templates/ios/FinanceTemplate/tests/02_tab_navigation.yaml

@@ -0,0 +1,24 @@
+appId: ${APP_BUNDLE_ID}
+---
+- launchApp
+- tapOn:
+    text: "Skip"
+    optional: true
+- tapOn:
+    text: "Get Started"
+    optional: true
+- tapOn:
+    text: "Cancel"
+    optional: true
+- assertVisible: "Overview"
+- tapOn: "Transactions"
+- waitForAnimationToEnd
+- tapOn: "Budgets"
+- waitForAnimationToEnd
+- tapOn: "Goals"
+- waitForAnimationToEnd
+- tapOn: "More"
+- waitForAnimationToEnd
+- tapOn: "Home"
+- waitForAnimationToEnd
+- assertVisible: "Overview"

package/templates/ios/FinanceTemplate/tests/03_add_transaction.yaml

@@ -0,0 +1,18 @@
+appId: ${APP_BUNDLE_ID}
+---
+- launchApp
+- tapOn:
+    text: "Skip"
+    optional: true
+- tapOn:
+    text: "Get Started"
+    optional: true
+- tapOn:
+    text: "Cancel"
+    optional: true
+- assertVisible: "Overview"
+- tapOn: "Add"
+- waitForAnimationToEnd
+- assertVisible: "Add Transaction"
+- tapOn: "Cancel"
+- waitForAnimationToEnd

package/templates/ios/FinanceTemplate/tests/04_budgets.yaml

@@ -0,0 +1,14 @@
+appId: ${APP_BUNDLE_ID}
+---
+- launchApp
+- tapOn:
+    text: "Skip"
+    optional: true
+- tapOn:
+    text: "Get Started"
+    optional: true
+- tapOn:
+    text: "Cancel"
+    optional: true
+- tapOn: "Budgets"
+- waitForAnimationToEnd

package/templates/ios/FinanceTemplate/tests/05_goals.yaml

@@ -0,0 +1,14 @@
+appId: ${APP_BUNDLE_ID}
+---
+- launchApp
+- tapOn:
+    text: "Skip"
+    optional: true
+- tapOn:
+    text: "Get Started"
+    optional: true
+- tapOn:
+    text: "Cancel"
+    optional: true
+- tapOn: "Goals"
+- waitForAnimationToEnd

package/templates/ios/FinanceTemplate/tests/06_transactions.yaml

@@ -0,0 +1,14 @@
+appId: ${APP_BUNDLE_ID}
+---
+- launchApp
+- tapOn:
+    text: "Skip"
+    optional: true
+- tapOn:
+    text: "Get Started"
+    optional: true
+- tapOn:
+    text: "Cancel"
+    optional: true
+- tapOn: "Transactions"
+- waitForAnimationToEnd

package/templates/ios/FinanceTemplate/tests/07_search_filter.yaml

@@ -0,0 +1,14 @@
+appId: ${APP_BUNDLE_ID}
+---
+- launchApp
+- tapOn:
+    text: "Skip"
+    optional: true
+- tapOn:
+    text: "Get Started"
+    optional: true
+- tapOn:
+    text: "Cancel"
+    optional: true
+- tapOn: "More"
+- waitForAnimationToEnd

package/templates/ios/FinanceTemplate/tests/08_full_e2e.yaml

@@ -0,0 +1,24 @@
+appId: ${APP_BUNDLE_ID}
+---
+- launchApp
+- tapOn:
+    text: "Skip"
+    optional: true
+- tapOn:
+    text: "Get Started"
+    optional: true
+- tapOn:
+    text: "Cancel"
+    optional: true
+- assertVisible: "Overview"
+- assertVisible: ".*Total Balance.*"
+- tapOn: "Transactions"
+- waitForAnimationToEnd
+- tapOn: "Budgets"
+- waitForAnimationToEnd
+- tapOn: "Goals"
+- waitForAnimationToEnd
+- tapOn: "More"
+- waitForAnimationToEnd
+- tapOn: "Home"
+- waitForAnimationToEnd

package/templates/ios/GameTemplate/GameTemplate/ARCHITECTURE.md

@@ -0,0 +1,145 @@
+# GameTemplate - iOS Architecture
+
+## Overview
+
+GameTemplate implements a **MVVM architecture** with SwiftUI, designed for casual games and gamified applications.
+
+## Architecture Diagram
+
+```mermaid
+graph TB
+    subgraph Views["Views (SwiftUI)"]
+        HM[HomeMenuView]
+        GV[GameView]
+        RV[ResultsView]
+        LBV[LeaderboardView]
+        SV[ShopView]
+        AV[AchievementsView]
+        PV[ProfileView]
+    end
+    
+    subgraph Managers["Managers"]
+        GM[GameManager]
+        PM[PlayerManager]
+    end
+    
+    subgraph Models["Models"]
+        GS[GameSession]
+        SC[Score]
+        LV[Level]
+        AC[Achievement]
+        SI[ShopItem]
+        PL[Player]
+        LB[LeaderboardEntry]
+    end
+    
+    subgraph Services["Services"]
+        MD[MockDataProvider]
+        LP[LocalPersistence]
+    end
+    
+    Views --> Managers
+    Managers --> Models
+    Views --> MD
+    MD --> Models
+    MD --> LP
+    Managers --> LP
+```
+
+## Data Flow
+
+```mermaid
+sequenceDiagram
+    participant U as User
+    participant V as View
+    participant GM as GameManager
+    participant PM as PlayerManager
+    participant MD as MockDataProvider
+    
+    U->>V: Start Game
+    V->>GM: startGame(level)
+    GM->>GM: Create GameSession
+    GM-->>V: Update UI
+    
+    U->>V: Answer Question
+    V->>GM: addScore(points)
+    GM-->>V: Update score
+    
+    U->>V: Complete Game
+    V->>GM: endGame()
+    GM->>PM: addScore(score)
+    GM->>PM: addCoins(coins)
+    GM->>MD: addGameSession(session)
+    PM->>LP: Save player state
+```
+
+## Project Structure
+
+```
+GameTemplate/
+├── App/
+│   ├── GameTemplateApp.swift      # @main entry point
+│   └── AppConfig.swift             # Centralized configuration
+├── Models/
+│   └── Models.swift                # All data models
+├── Core/
+│   ├── Theme/Colors.swift          # Color system
+│   ├── Components/                 # Reusable UI components
+│   └── Managers/                   # State management
+├── Features/                       # Feature screens
+├── MockData/
+│   └── MockDataProvider.swift     # Mock data + CRUD
+└── Data/
+    └── LocalPersistence.swift      # JSON persistence
+```
+
+## State Management
+
+### GameManager
+- Manages active game session
+- Tracks score, timer, pause state
+- Handles game lifecycle (start/pause/end)
+
+### PlayerManager
+- Manages player state (level, XP, currency, achievements)
+- Handles currency transactions
+- Manages lives regeneration
+- Persists to UserDefaults
+
+### MockDataProvider
+- Observable singleton for mock data
+- CRUD operations for all game entities
+- Persists mutable state (sessions, purchases)
+
+## Models
+
+### GameSession
+- Represents a single game play session
+- Tracks score, duration, level, completion status
+
+### Level
+- Game levels with difficulty, unlock requirements
+- Progressive difficulty system
+
+### Achievement
+- Unlockable achievements with rarity tiers
+- Tracks unlock status and date
+
+### Player
+- Player profile with stats, currency, achievements
+- Level and XP progression system
+
+### LeaderboardEntry
+- Leaderboard entries with rank, player, score
+
+## Persistence
+
+- **UserDefaults**: Player state, app settings, onboarding status
+- **LocalPersistence**: JSON files for game sessions, purchased items
+- **In-Memory**: MockDataProvider for runtime data
+
+## Navigation
+
+- **TabView**: Main navigation (Play, Leaderboard, Shop, Profile)
+- **NavigationStack**: Per-tab navigation
+- **fullScreenCover**: Game and Results screens

package/templates/ios/GameTemplate/GameTemplate/App/AppConfig.swift

@@ -0,0 +1,151 @@
+import SwiftUI
+
+// CUSTOMIZE:BRANDING - App identity and configuration
+struct AppConfig {
+    static let appName = "GameTemplate"
+    static let bundleId = "com.appship.game"
+    static let appStoreId = "123456789"
+    static let version = "1.0.0"
+    
+    // CUSTOMIZE:FEATURES - Enable/disable app features
+    struct Features {
+        static let enableLeaderboard = true
+        static let enableMultiplayer = false
+        static let enableShop = true
+        static let enableAchievements = true
+        static let enableDailyChallenge = true
+        static let enableLives = true
+        static let enableSoundEffects = true
+        static let enableGameCenter = false
+        static let enableTutorial = true
+    }
+    
+    // CUSTOMIZE:API - Backend endpoints
+    struct API {
+        static let baseURL = "https://api.example.com"
+        static let apiVersion = "v1"
+        static let timeout: TimeInterval = 30
+        
+        static var leaderboardURL: String { "\(baseURL)/\(apiVersion)/leaderboard" }
+        static var achievementsURL: String { "\(baseURL)/\(apiVersion)/achievements" }
+        static var shopURL: String { "\(baseURL)/\(apiVersion)/shop" }
+        static var gameSessionURL: String { "\(baseURL)/\(apiVersion)/sessions" }
+    }
+    
+    // CUSTOMIZE:BUSINESS - Business rules and game mechanics
+    struct Business {
+        static let startingLives = 5
+        static let livesRegenMinutes = 30
+        static let startingCoins = 100
+        static let startingGems = 10
+        static let maxLevel = 50
+        static let dailyChallengeRewardCoins = 50
+        static let dailyChallengeRewardGems = 5
+    }
+    
+    // CUSTOMIZE:CONTENT - App copy and links
+    struct Content {
+        static let supportEmail = "support@example.com"
+        static let supportPhone = "+1-800-123-4567"
+        static let privacyPolicyURL = "https://example.com/privacy"
+        static let termsURL = "https://example.com/terms"
+        static let faqURL = "https://example.com/faq"
+    }
+    
+    // CUSTOMIZE:THEME - App appearance
+    struct Theme {
+        static let primaryColor = Color("Primary")
+        static let secondaryColor = Color("Secondary")
+        static let accentColor = Color("Accent")
+        static let backgroundColor = Color("Background")
+        static let surfaceColor = Color("Surface")
+        static let errorColor = Color.red
+        static let successColor = Color.green
+        static let warningColor = Color.orange
+        
+        // Fallback colors if asset catalog colors aren't set
+        static let primaryFallback = Color(red: 0.26, green: 0.44, blue: 0.90)
+        static let secondaryFallback = Color(red: 0.95, green: 0.95, blue: 0.97)
+        
+        struct Typography {
+            static let largeTitle = Font.system(size: 34, weight: .bold)
+            static let title = Font.system(size: 28, weight: .bold)
+            static let title2 = Font.system(size: 22, weight: .bold)
+            static let title3 = Font.system(size: 20, weight: .semibold)
+            static let headline = Font.system(size: 17, weight: .semibold)
+            static let body = Font.system(size: 17, weight: .regular)
+            static let callout = Font.system(size: 16, weight: .regular)
+            static let subheadline = Font.system(size: 15, weight: .regular)
+            static let footnote = Font.system(size: 13, weight: .regular)
+            static let caption = Font.system(size: 12, weight: .regular)
+        }
+        
+        struct Spacing {
+            static let xxs: CGFloat = 4
+            static let xs: CGFloat = 8
+            static let sm: CGFloat = 12
+            static let md: CGFloat = 16
+            static let lg: CGFloat = 24
+            static let xl: CGFloat = 32
+            static let xxl: CGFloat = 48
+        }
+        
+        struct CornerRadius {
+            static let small: CGFloat = 8
+            static let medium: CGFloat = 12
+            static let large: CGFloat = 16
+            static let xl: CGFloat = 24
+        }
+    }
+    
+    // CUSTOMIZE:ONBOARDING - Onboarding slides content
+    struct Onboarding {
+        static let slides: [(title: String, subtitle: String, image: String)] = [
+            ("Welcome to \(appName)", "Start your gaming journey and compete with players worldwide", "gamecontroller.fill"),
+            ("Earn Rewards", "Complete levels, unlock achievements, and collect coins", "star.fill"),
+            ("Climb the Leaderboard", "Beat your high scores and become the champion", "trophy.fill")
+        ]
+    }
+}
+
+// MARK: - App State
+class AppState: ObservableObject {
+    @Published var hasCompletedOnboarding: Bool {
+        didSet {
+            UserDefaults.standard.set(hasCompletedOnboarding, forKey: "hasCompletedOnboarding")
+        }
+    }
+    @Published var currentLevel: Int = 1
+    @Published var isLoading: Bool = false
+    @Published var error: AppError?
+    
+    init() {
+        self.hasCompletedOnboarding = UserDefaults.standard.bool(forKey: "hasCompletedOnboarding")
+        self.currentLevel = UserDefaults.standard.integer(forKey: "currentLevel")
+        if currentLevel == 0 { currentLevel = 1 }
+    }
+    
+    func reset() {
+        hasCompletedOnboarding = false
+        currentLevel = 1
+    }
+}
+
+// MARK: - App Error
+enum AppError: Error, LocalizedError, Identifiable {
+    case network(String)
+    case validation(String)
+    case gameSession(String)
+    case unknown(String)
+    
+    var id: String { localizedDescription }
+    
+    var errorDescription: String? {
+        switch self {
+        case .network(let message): return message
+        case .validation(let message): return message
+        case .gameSession(let message): return message
+        case .unknown(let message): return message
+        }
+    }
+}