@shaykec/app-agent 1.0.0

package/templates/CATALOG.md

@@ -0,0 +1,898 @@
+# Template Catalog for AI Agents
+
+> **Purpose:** Machine-readable index for LLM/agent template selection.
+> Read this file first to determine which template best matches a user's app idea.
+
+---
+
+## Decision Matrix
+
+| Template | Category | Best-For Keywords | Platforms | Screens |
+|---|---|---|---|---|
+| ShopTemplate | E-commerce | shopping, store, products, cart, checkout, orders, payments, catalog, marketplace, retail, inventory, wishlist, Apple Pay, Google Pay | iOS, Android | 15+ |
+| TrackTemplate | Habit Tracker | habits, tracking, streaks, daily routines, goals, progress, wellness, fitness tracker, self-improvement, reminders, achievements, heatmap | iOS, Android | 13 |
+| BookTemplate | Booking / Appointments | booking, appointments, scheduling, calendar, reservations, services, providers, salon, spa, medical, fitness classes, time slots | iOS, Android | 16 |
+| SocialTemplate | Social Media | social, feed, posts, stories, followers, likes, comments, sharing, profiles, Instagram-like, community, photos, messaging | iOS, Android | 17 |
+| FinanceTemplate | Personal Finance | finance, budget, money, transactions, expenses, income, savings, accounts, banking, bills, spending, goals, investments | iOS, Android | 15 |
+| ChatTemplate | Messaging | chat, messaging, conversations, real-time, voice messages, group chat, calls, contacts, WhatsApp-like, Slack-like, Telegram-like | iOS, Android | 14 |
+| LearnTemplate | Education / Learning | courses, lessons, quizzes, flashcards, progress, tutorials, certifications, study, vocabulary, language learning, Duolingo-like, Coursera-like | iOS, Android | 12 |
+| HealthTemplate | Health / Fitness | workout, exercise, calories, meals, nutrition, steps, heart rate, sleep, meditation, weight, fitness, gym, MyFitnessPal-like, Strava-like | iOS, Android | 12 |
+| TaskTemplate | Productivity / Tasks | tasks, todos, projects, kanban, notes, lists, deadlines, priorities, tags, reminders, GTD, Todoist-like, Trello-like, productivity | iOS, Android | 12 |
+| MediaTemplate | Content / Media | music, podcast, video, streaming, audio, playlist, library, downloads, episodes, recipes, articles, Spotify-like, player | iOS, Android | 12 |
+| MapTemplate | Location / Discovery | map, nearby, places, directions, delivery, ride, location, explore, route, navigation, check-in, Yelp-like, city guide | iOS, Android | 11 |
+| DashTemplate | Dashboard / Analytics | dashboard, analytics, metrics, charts, KPIs, real-time, monitoring, admin, statistics, IoT, smart home, widgets | iOS, Android | 9 |
+| FamilyTemplate | Family / Kids | family, kids, chores, allowance, screen time, shared calendar, parenting, safety, location sharing, milestones, baby | iOS, Android | 11 |
+| GameTemplate | Casual Game / Gamified | game, score, levels, achievements, leaderboard, multiplayer, puzzle, trivia, cards, brain training, rewards, coins | iOS, Android | 10 |
+
+---
+
+## Template Details
+
+### ShopTemplate -- E-Commerce App
+
+**One-line:** Complete shopping app with product browsing, cart, checkout, orders, and payments.
+
+**Best match when:**
+- User wants to sell products online (physical or digital)
+- User needs a storefront, product catalog, or marketplace
+- User mentions shopping cart, checkout, or order tracking
+- User wants Apple Pay / Google Pay integration
+
+**NOT a match when:**
+- User wants a social app without commerce (use SocialTemplate)
+- User wants to book services/appointments (use BookTemplate)
+- User only needs budget tracking (use FinanceTemplate)
+
+**Key features:**
+- Product browsing with categories, search, and filters
+- Product detail pages with image galleries and variants (size, color)
+- Shopping cart with quantity management and discount codes
+- Multi-step checkout (address, shipping method, payment, review)
+- Order history with status tracking and timeline
+- User authentication (email, Apple Sign-In, Google)
+- Wishlist / saved products
+- Product reviews and ratings
+- Store locator with map integration
+- Push notifications
+- Dark mode and accessibility (VoiceOver)
+
+**Screens (iOS):**
+HomeView, ProductListView, ProductDetailView, CartView, CheckoutView, OrdersView, WishlistView, StoreLocatorView, ProfileView, AuthFlowView, OnboardingView
+
+**Screens (Android):**
+HomeScreen, ProductListScreen, CartScreen, ProfileScreen, WishlistScreen, Navigation
+
+**Feature flags (AppConfig):**
+enableApplePay/enableGooglePay, enableReviews, enableWishlist, enableGuestCheckout, enableARPreview, enableStoreLocator, enableBarcodeScanner, requireAuth, enableSocialLogin
+
+**File paths:**
+
+| | iOS | Android |
+|---|---|---|
+| Root | `samples/templates/ios/ShopTemplate/` | `samples/templates/android/ShopTemplate/` |
+| AppConfig | `ShopTemplate/App/AppConfig.swift` | `app/src/main/kotlin/com/appship/shop/AppConfig.kt` |
+| Mock Data | `ShopTemplate/MockData/MockDataProvider.swift` | `app/src/main/kotlin/com/appship/shop/mock/MockDataProvider.kt` |
+| Models | `ShopTemplate/Models/Models.swift` | `app/src/main/kotlin/com/appship/shop/data/model/` |
+| Features | `ShopTemplate/Features/` | `app/src/main/kotlin/com/appship/shop/features/` |
+| Theme | `ShopTemplate/Core/Theme/` | `app/src/main/kotlin/com/appship/shop/core/theme/` |
+
+**Docs:** README.md, ARCHITECTURE.md, API_INTEGRATION.md, CUSTOMIZATION.md
+
+---
+
+### TrackTemplate -- Habit Tracker App
+
+**One-line:** Daily habit tracking app with streaks, achievements, statistics, and reminders.
+
+**Best match when:**
+- User wants to track daily habits, routines, or goals
+- User mentions streaks, progress tracking, or self-improvement
+- User wants a wellness, fitness, or productivity tracker
+- User needs charts, heatmaps, or statistics for personal data
+
+**NOT a match when:**
+- User wants to track financial transactions (use FinanceTemplate)
+- User wants to book appointments (use BookTemplate)
+- User wants a social sharing platform (use SocialTemplate)
+
+**Key features:**
+- Daily habit completion with one-tap tracking
+- Customizable habits with icons, colors, and categories
+- Multiple frequency options (daily, weekly, custom)
+- Streak tracking (current and longest)
+- Calendar heat map visualization
+- Statistics and charts (completion rates, trends)
+- Achievement system with milestones
+- Streak freeze for missed days
+- Customizable reminders per habit
+- Home screen widgets
+- HealthKit / Health Connect integration ready
+- 8 built-in categories, 30+ icons, 15 color options
+
+**Screens (iOS):**
+TodayView, DashboardView, HabitsListView, AchievementsView, SettingsView
+
+**Screens (Android):**
+TodayScreen, DashboardScreen, HabitsListScreen, AddHabitScreen, HabitDetailScreen, AchievementsScreen, SettingsScreen, Navigation
+
+**Feature flags (AppConfig):**
+enableHealthKit/enableHealthConnect, enableWidgets, enableReminders, enableAchievements, enableSocialSharing, enableCloudSync, enableStreakFreeze, enableInsights
+
+**File paths:**
+
+| | iOS | Android |
+|---|---|---|
+| Root | `samples/templates/ios/TrackTemplate/` | `samples/templates/android/TrackTemplate/` |
+| AppConfig | `TrackTemplate/App/AppConfig.swift` | `app/src/main/kotlin/com/appship/track/AppConfig.kt` |
+| Mock Data | `TrackTemplate/MockData/MockDataProvider.swift` | `app/src/main/kotlin/com/appship/track/mock/MockDataProvider.kt` |
+| Models | `TrackTemplate/Models/Models.swift` | `app/src/main/kotlin/com/appship/track/data/model/` |
+| Features | `TrackTemplate/Features/` | `app/src/main/kotlin/com/appship/track/features/` |
+
+**Docs:** README.md, ARCHITECTURE.md, API_INTEGRATION.md, CUSTOMIZATION.md
+
+---
+
+### BookTemplate -- Booking / Appointments App
+
+**One-line:** Service booking app with provider discovery, calendar scheduling, and appointment management.
+
+**Best match when:**
+- User wants to book appointments or schedule services
+- User is building for a salon, spa, medical clinic, fitness studio, or any service business
+- User mentions time slots, calendars, providers, or reservations
+- User wants a restaurant reservation or table booking app
+
+**NOT a match when:**
+- User wants to sell physical products (use ShopTemplate)
+- User wants a general social platform (use SocialTemplate)
+- User wants a messaging app (use ChatTemplate)
+
+**Key features:**
+- Service discovery with categories (health, beauty, fitness, medical, professional, home, auto, education)
+- Provider profiles with photos, services, reviews, and location
+- Multi-step booking flow (service, date/time, confirmation)
+- Interactive calendar with available time slots
+- Booking management (upcoming, past, cancel, reschedule)
+- Favorites system for preferred providers
+- Search with real-time suggestions and filters
+- Map integration (MapKit / Google Maps) for nearby providers
+- Review and rating system with owner responses
+- Business hours and availability display
+- Cancellation policy enforcement
+- Push notification reminders
+
+**Business type presets (Android):** Salon, Spa, Medical, Fitness, Restaurant
+
+**Screens (iOS):**
+DiscoveryView, ProviderDetailView, SearchView, MapExploreView, BookingView, BookingsView, ProfileView, FavoritesView, OnboardingView
+
+**Screens (Android):**
+DiscoveryScreen, ProviderDetailScreen, SearchScreen, BookingScreen, BookingsScreen, ProfileScreen, Navigation
+
+**Feature flags (AppConfig):**
+enableMaps, enableReviews, enableFavorites, enableNotifications, enableCalendarSync, enableOnlinePayment, enableCancellation, enableRescheduling, requireAuth
+
+**File paths:**
+
+| | iOS | Android |
+|---|---|---|
+| Root | `samples/templates/ios/BookTemplate/` | `samples/templates/android/BookTemplate/` |
+| AppConfig | `BookTemplate/App/AppConfig.swift` | `app/src/main/kotlin/com/appship/book/AppConfig.kt` |
+| Mock Data | `BookTemplate/MockData/MockDataProvider.swift` | `app/src/main/kotlin/com/appship/book/mock/MockDataProvider.kt` |
+| Models | `BookTemplate/Models/Models.swift` | `app/src/main/kotlin/com/appship/book/data/model/` |
+| Features | `BookTemplate/Features/` | `app/src/main/kotlin/com/appship/book/features/` |
+
+**Docs:** README.md, ARCHITECTURE.md, API_INTEGRATION.md, CUSTOMIZATION.md
+
+---
+
+### SocialTemplate -- Social Media App
+
+**One-line:** Instagram-style social app with feed, stories, profiles, messaging, and content sharing.
+
+**Best match when:**
+- User wants a social media or community app
+- User mentions feed, posts, stories, followers, or likes
+- User wants photo/video sharing with engagement features
+- User is building a dating app, professional network, or community forum
+- User wants user profiles with follow/follower relationships
+
+**NOT a match when:**
+- User wants a pure messaging app without feed (use ChatTemplate)
+- User wants to sell products (use ShopTemplate)
+- User wants to track personal data/habits (use TrackTemplate)
+
+**Key features:**
+- Infinite scroll feed with posts (text, images, videos)
+- Instagram-style stories with viewer
+- Post creation with media picker (PhotosUI / Coil)
+- Like, comment, share, and save interactions
+- User profiles with followers/following counts and post grid
+- Direct messaging / conversations
+- Search and explore (users, hashtags, content)
+- Notifications feed (likes, comments, follows, mentions)
+- @mentions and hashtags
+- Settings and privacy controls
+
+**App type presets (Android):** Instagram-like, Twitter-like, TikTok-like, LinkedIn-like
+
+**Screens (iOS):**
+FeedView, CommentsView, StoryViewerView, CreatePostView, ProfileView, MessagesView, SearchView, NotificationsView, SettingsView
+
+**Screens (Android):**
+FeedScreen, CommentsScreen, CreatePostScreen, ProfileScreen, MessagesScreen, SearchScreen, NotificationsScreen, SettingsScreen, Navigation
+
+**Feature flags (AppConfig):**
+enableStories, enableReels, enableLiveVideo, enableDirectMessages, enableGroups, enableMarketplace, enableNotifications, requireAuth, maxPostLength, maxMediaPerPost
+
+**File paths:**
+
+| | iOS | Android |
+|---|---|---|
+| Root | `samples/templates/ios/SocialTemplate/` | `samples/templates/android/SocialTemplate/` |
+| AppConfig | `SocialTemplate/App/AppConfig.swift` | `app/src/main/kotlin/com/appship/social/AppConfig.kt` |
+| Mock Data | `SocialTemplate/MockData/MockDataProvider.swift` | `app/src/main/kotlin/com/appship/social/mock/MockDataProvider.kt` |
+| Models | `SocialTemplate/Models/Models.swift` | `app/src/main/kotlin/com/appship/social/data/model/` |
+| Features | `SocialTemplate/Features/` | `app/src/main/kotlin/com/appship/social/features/` |
+
+**Docs:** README.md, ARCHITECTURE.md, API_INTEGRATION.md, CUSTOMIZATION.md
+
+---
+
+### FinanceTemplate -- Personal Finance App
+
+**One-line:** Personal finance app with accounts, transactions, budgets, savings goals, and spending insights.
+
+**Best match when:**
+- User wants to track money, expenses, or income
+- User mentions budgeting, savings goals, or financial planning
+- User wants to manage bank accounts or investment tracking
+- User needs spending reports, charts, or financial insights
+- User wants bill tracking or payment reminders
+
+**NOT a match when:**
+- User wants to sell products (use ShopTemplate)
+- User wants to track non-financial habits (use TrackTemplate)
+- User wants a social platform (use SocialTemplate)
+
+**Key features:**
+- Dashboard with total balance, income/expense summary, and quick actions
+- Multiple account types (checking, savings, credit card, investment)
+- Transaction tracking with income and expense categories
+- Category-based budget planning with progress bars
+- Savings goals with progress visualization
+- Bill tracking and reminders
+- Monthly spending reports and trends
+- Insights and tips based on spending patterns
+- CSV and PDF data export
+- Biometric authentication (Face ID / fingerprint)
+- Encrypted local storage (SQLCipher on Android)
+- 9 expense categories and 5 income categories built-in
+
+**Screens (iOS):**
+HomeView (Dashboard), TransactionsView, AddTransactionView, BudgetsView, GoalsView, SettingsView, MainTabView
+
+**Screens (Android):**
+HomeScreen, TransactionsScreen, BudgetsScreen, GoalsScreen, SettingsScreen, Navigation
+
+**Feature flags (AppConfig):**
+enableBiometricAuth, enableBudgets, enableGoals, enableInsights, enableBillReminders, enableExport, enableNotifications, requireAuth, defaultCurrency
+
+**File paths:**
+
+| | iOS | Android |
+|---|---|---|
+| Root | `samples/templates/ios/FinanceTemplate/` | `samples/templates/android/FinanceTemplate/` |
+| AppConfig | `FinanceTemplate/App/AppConfig.swift` | `app/src/main/kotlin/com/appship/finance/AppConfig.kt` |
+| Mock Data | `FinanceTemplate/MockData/MockDataProvider.swift` | `app/src/main/kotlin/com/appship/finance/mock/MockDataProvider.kt` |
+| Models | `FinanceTemplate/Models/Models.swift` | `app/src/main/kotlin/com/appship/finance/data/model/` |
+| Features | `FinanceTemplate/Features/` | `app/src/main/kotlin/com/appship/finance/features/` |
+
+**Docs:** README.md, ARCHITECTURE.md, API_INTEGRATION.md, CUSTOMIZATION.md
+
+---
+
+### ChatTemplate -- Messaging App
+
+**One-line:** Real-time messaging app with conversations, group chats, voice messages, media sharing, and calls.
+
+**Best match when:**
+- User wants a messaging or chat app
+- User mentions real-time communication, conversations, or group chats
+- User is building a WhatsApp-like, Slack-like, Telegram-like, or Discord-like app
+- User wants voice/video calling features
+- User needs read receipts, typing indicators, or online status
+
+**NOT a match when:**
+- User wants a social feed with posts and stories (use SocialTemplate)
+- User wants to sell products (use ShopTemplate)
+- User wants to track personal data (use TrackTemplate)
+
+**Key features:**
+- Conversations list with pinned, muted, and archived chats
+- Real-time messaging with message bubbles
+- Media sharing (photos, videos, files)
+- Group chats with admin controls
+- Voice messages with waveform visualization
+- Read receipts and delivery status indicators
+- Typing indicators in real-time
+- Online/offline status display
+- Message reactions with emoji
+- Voice and video call history
+- Contact management with invite support
+- WebSocket-based real-time communication (Android)
+
+**App type presets (Android):** WhatsApp-like, Slack-like, Telegram-like, Discord-like
+
+**Screens (iOS):**
+ConversationsView, ChatView, NewChatView, CallsView, ContactsView, SettingsView, MainTabView
+
+**Screens (Android):**
+ConversationsScreen, ChatScreen, CallsScreen, ContactsScreen, SettingsScreen, Navigation
+
+**Feature flags (AppConfig):**
+enableGroupChats, enableVoiceMessages, enableMediaSharing, enableReadReceipts, enableTypingIndicators, enableOnlineStatus, enableReactions, enableSearch, enableNotifications, maxGroupSize, maxMessageLength, maxMediaSize
+
+**File paths:**
+
+| | iOS | Android |
+|---|---|---|
+| Root | `samples/templates/ios/ChatTemplate/` | `samples/templates/android/ChatTemplate/` |
+| AppConfig | `ChatTemplate/App/AppConfig.swift` | `app/src/main/kotlin/com/appship/chat/AppConfig.kt` |
+| Mock Data | `ChatTemplate/MockData/MockDataProvider.swift` | `app/src/main/kotlin/com/appship/chat/mock/MockDataProvider.kt` |
+| Models | `ChatTemplate/Models/Models.swift` | `app/src/main/kotlin/com/appship/chat/data/model/` |
+| Features | `ChatTemplate/Features/` | `app/src/main/kotlin/com/appship/chat/features/` |
+
+**Docs:** README.md, ARCHITECTURE.md, API_INTEGRATION.md, CUSTOMIZATION.md
+
+---
+
+### LearnTemplate -- Education / Learning App
+
+**One-line:** Interactive learning app with courses, lessons, quizzes, flashcards, and progress tracking.
+
+**Best match when:**
+- User wants an educational or learning app
+- User mentions courses, lessons, quizzes, or flashcards
+- User is building a language learning, coding tutorial, or skills training app
+- User wants progress tracking with XP, levels, or streaks
+
+**NOT a match when:**
+- User wants to track personal habits without structured content (use TrackTemplate)
+- User wants a social platform (use SocialTemplate)
+- User wants to book tutoring sessions (use BookTemplate)
+
+**Key features:**
+- Course catalog with categories, difficulty levels, and progress indicators
+- Lesson player with text, image, and video step content
+- Quiz engine (multiple choice, fill-in-the-blank, matching, true/false)
+- Flashcard system with spaced repetition algorithm
+- Progress tracking with XP, levels, and streaks
+- Leaderboard with daily, weekly, and all-time rankings
+- Achievement system with completion badges and certificates
+- Offline content download for learning on the go
+- Daily learning goals with reminder notifications
+- Search and filter courses by category, difficulty, duration
+
+**Screens (iOS):**
+CourseListView, CourseDetailView, LessonPlayerView, QuizView, FlashcardView, ProgressDashboardView, LeaderboardView, ProfileView, SettingsView, OnboardingView
+
+**Screens (Android):**
+CourseListScreen, CourseDetailScreen, LessonPlayerScreen, QuizScreen, FlashcardScreen, ProgressDashboardScreen, LeaderboardScreen, ProfileScreen, SettingsScreen, Navigation
+
+**Feature flags (AppConfig):**
+enableQuizzes, enableFlashcards, enableLeaderboard, enableCertificates, enableOfflineDownload, enableStreaks, enableVideoLessons, enableDailyGoals, enableNotifications
+
+**File paths:**
+
+| | iOS | Android |
+|---|---|---|
+| Root | `templates/ios/LearnTemplate/` | `templates/android/LearnTemplate/` |
+| AppConfig | `LearnTemplate/App/AppConfig.swift` | `app/src/main/kotlin/com/appship/learn/AppConfig.kt` |
+| Mock Data | `LearnTemplate/MockData/MockDataProvider.swift` | `app/src/main/kotlin/com/appship/learn/mock/MockDataProvider.kt` |
+| Models | `LearnTemplate/Models/Models.swift` | `app/src/main/kotlin/com/appship/learn/data/model/` |
+| Features | `LearnTemplate/Features/` | `app/src/main/kotlin/com/appship/learn/features/` |
+
+**Docs:** README.md, ARCHITECTURE.md, API_INTEGRATION.md, CUSTOMIZATION.md
+
+---
+
+### HealthTemplate -- Health / Fitness App
+
+**One-line:** Health and fitness app with workouts, nutrition logging, health metrics, and progress tracking.
+
+**Best match when:**
+- User wants a fitness or workout tracking app
+- User mentions exercise, calories, nutrition, or meal logging
+- User is building a gym companion, running tracker, or wellness app
+- User wants health data integration (HealthKit / Health Connect)
+
+**NOT a match when:**
+- User wants to track general habits without health focus (use TrackTemplate)
+- User wants to book fitness classes (use BookTemplate)
+- User wants a social fitness community (use SocialTemplate)
+
+**Key features:**
+- Health dashboard with daily metrics (steps, calories, water, sleep)
+- Workout library with categories (strength, cardio, yoga, HIIT)
+- Workout player with timer, sets, reps, and rest intervals
+- Meal and nutrition logging with food database search
+- Weight and body metrics tracking with trend charts
+- Apple HealthKit / Google Health Connect deep integration
+- Goal setting (daily steps, calorie target, workout minutes)
+- Water intake tracker with visual progress
+- Progress photos timeline with comparison view
+- Statistics and insights with weekly/monthly reports
+
+**Screens (iOS):**
+DashboardView, WorkoutListView, WorkoutPlayerView, ExerciseDetailView, NutritionLogView, MealLogView, ProgressChartsView, ProfileView, SettingsView, OnboardingView
+
+**Screens (Android):**
+DashboardScreen, WorkoutListScreen, WorkoutPlayerScreen, ExerciseDetailScreen, NutritionLogScreen, MealLogScreen, ProgressChartsScreen, ProfileScreen, SettingsScreen, Navigation
+
+**Feature flags (AppConfig):**
+enableWorkouts, enableNutrition, enableHealthKit/enableHealthConnect, enableProgressPhotos, enableWaterTracker, enableSleepTracking, enableMeditation, enableCommunity, enableReminders
+
+**File paths:**
+
+| | iOS | Android |
+|---|---|---|
+| Root | `templates/ios/HealthTemplate/` | `templates/android/HealthTemplate/` |
+| AppConfig | `HealthTemplate/App/AppConfig.swift` | `app/src/main/kotlin/com/appship/health/AppConfig.kt` |
+| Mock Data | `HealthTemplate/MockData/MockDataProvider.swift` | `app/src/main/kotlin/com/appship/health/mock/MockDataProvider.kt` |
+| Models | `HealthTemplate/Models/Models.swift` | `app/src/main/kotlin/com/appship/health/data/model/` |
+| Features | `HealthTemplate/Features/` | `app/src/main/kotlin/com/appship/health/features/` |
+
+**Docs:** README.md, ARCHITECTURE.md, API_INTEGRATION.md, CUSTOMIZATION.md
+
+---
+
+### TaskTemplate -- Productivity / Task Management App
+
+**One-line:** Task management app with projects, kanban boards, calendar view, tags, and recurring tasks.
+
+**Best match when:**
+- User wants a to-do list or task management app
+- User mentions projects, kanban boards, or productivity
+- User is building a GTD system, project tracker, or team task board
+- User wants multiple task views (list, board, calendar)
+
+**NOT a match when:**
+- User wants to track habits or streaks (use TrackTemplate)
+- User wants to manage finances (use FinanceTemplate)
+- User wants a note-taking app without task structure (use MediaTemplate)
+
+**Key features:**
+- Task creation with title, description, priority, due date, and tags
+- Project and list organization with drag-and-drop reorder
+- Multiple views: list view, kanban board, calendar view
+- Sub-tasks and checklists within tasks
+- Priority levels (P1-P4) with color coding
+- Due date and reminder system with smart notifications
+- Tags and labels for cross-project filtering
+- Quick add from anywhere (widget, share extension)
+- Natural language date parsing ("tomorrow", "next Monday")
+- Recurring tasks with flexible schedules
+- Focus mode with today view
+- Archive and completed tasks history with search
+
+**Screens (iOS):**
+InboxView, ProjectListView, ProjectDetailView, TaskDetailView, CalendarView, KanbanBoardView, TagsFilterView, SearchView, SettingsView, OnboardingView
+
+**Screens (Android):**
+InboxScreen, ProjectListScreen, ProjectDetailScreen, TaskDetailScreen, CalendarScreen, KanbanBoardScreen, TagsFilterScreen, SearchScreen, SettingsScreen, Navigation
+
+**Feature flags (AppConfig):**
+enableKanban, enableCalendarView, enableSubtasks, enableRecurring, enableTags, enableCollaboration, enableWidgets, enableQuickAdd, enableFocusMode, enableNaturalLanguage
+
+**File paths:**
+
+| | iOS | Android |
+|---|---|---|
+| Root | `templates/ios/TaskTemplate/` | `templates/android/TaskTemplate/` |
+| AppConfig | `TaskTemplate/App/AppConfig.swift` | `app/src/main/kotlin/com/appship/task/AppConfig.kt` |
+| Mock Data | `TaskTemplate/MockData/MockDataProvider.swift` | `app/src/main/kotlin/com/appship/task/mock/MockDataProvider.kt` |
+| Models | `TaskTemplate/Models/Models.swift` | `app/src/main/kotlin/com/appship/task/data/model/` |
+| Features | `TaskTemplate/Features/` | `app/src/main/kotlin/com/appship/task/features/` |
+
+**Docs:** README.md, ARCHITECTURE.md, API_INTEGRATION.md, CUSTOMIZATION.md
+
+---
+
+### MediaTemplate -- Content / Media Player App
+
+**One-line:** Media consumption app with browsing, audio/video player, playlists, downloads, and persistent mini-player.
+
+**Best match when:**
+- User wants a podcast, music, or video streaming app
+- User mentions playlists, episodes, or media playback
+- User is building a recipe app, audiobook player, or content library
+- User wants a persistent mini-player with background playback
+
+**NOT a match when:**
+- User wants a social feed with media posts (use SocialTemplate)
+- User wants to sell media content (use ShopTemplate)
+- User wants real-time video chat (use ChatTemplate)
+
+**Key features:**
+- Media browser with categories, featured content, and trending
+- Detail page with description, metadata, and related items
+- Full-screen audio/video player with standard controls
+- Persistent mini-player bar across all screens
+- Playback controls (play/pause, skip, seek, speed adjustment)
+- Playlist creation and queue management
+- Library with favorites, history, and downloads
+- Background audio playback with lock screen controls
+- Offline download with progress tracking
+- Sleep timer for bedtime listening
+- Episode and chapter navigation
+- Search with filters (type, duration, category)
+
+**Screens (iOS):**
+HomeView, BrowseView, DetailView, PlayerFullView, PlayerMiniView, LibraryView, PlaylistDetailView, DownloadsView, SearchView, SettingsView
+
+**Screens (Android):**
+HomeScreen, BrowseScreen, DetailScreen, PlayerFullScreen, PlayerMiniScreen, LibraryScreen, PlaylistDetailScreen, DownloadsScreen, SearchScreen, SettingsScreen, Navigation
+
+**Feature flags (AppConfig):**
+enableAudioPlayer, enableVideoPlayer, enableDownloads, enablePlaylists, enableSleepTimer, enableBackgroundPlayback, enableChromecast, enableComments, enableHistory
+
+**File paths:**
+
+| | iOS | Android |
+|---|---|---|
+| Root | `templates/ios/MediaTemplate/` | `templates/android/MediaTemplate/` |
+| AppConfig | `MediaTemplate/App/AppConfig.swift` | `app/src/main/kotlin/com/appship/media/AppConfig.kt` |
+| Mock Data | `MediaTemplate/MockData/MockDataProvider.swift` | `app/src/main/kotlin/com/appship/media/mock/MockDataProvider.kt` |
+| Models | `MediaTemplate/Models/Models.swift` | `app/src/main/kotlin/com/appship/media/data/model/` |
+| Features | `MediaTemplate/Features/` | `app/src/main/kotlin/com/appship/media/features/` |
+
+**Docs:** README.md, ARCHITECTURE.md, API_INTEGRATION.md, CUSTOMIZATION.md
+
+---
+
+### MapTemplate -- Location / Discovery App
+
+**One-line:** Location-based app with full-screen map, place discovery, search, directions, and favorites.
+
+**Best match when:**
+- User wants a location-based or place discovery app
+- User mentions maps, nearby places, directions, or location
+- User is building a city guide, delivery tracker, or real estate app
+- User wants place details with reviews, photos, and hours
+
+**NOT a match when:**
+- User wants to book services at locations (use BookTemplate)
+- User wants social check-ins as the primary feature (use SocialTemplate)
+- User wants a ride-sharing app with real-time tracking (consider ChatTemplate + MapTemplate)
+
+**Key features:**
+- Full-screen map as primary interface (MapKit / Google Maps)
+- Place pins with clustering for high-density areas
+- Place detail cards with photos, hours, reviews, and contact info
+- Search with autocomplete and recent searches
+- Filters (distance, category, rating, price range, open now)
+- Directions and route display
+- Current location tracking with permission flow
+- Geofencing for proximity alerts
+- List view toggle (switch between map and list)
+- Favorites system with lists
+- User reviews and ratings
+- Share location or place with others
+
+**Screens (iOS):**
+MapView, PlaceListView, PlaceDetailView, RouteView, SearchView, FiltersView, FavoritesView, ProfileView, SettingsView, OnboardingView
+
+**Screens (Android):**
+MapScreen, PlaceListScreen, PlaceDetailScreen, RouteScreen, SearchScreen, FiltersScreen, FavoritesScreen, ProfileScreen, SettingsScreen, Navigation
+
+**Feature flags (AppConfig):**
+enableDirections, enableReviews, enableFilters, enableGeofence, enableOfflineMaps, enableCheckin, enableRouteTracking, enableARView, enableFavorites
+
+**File paths:**
+
+| | iOS | Android |
+|---|---|---|
+| Root | `templates/ios/MapTemplate/` | `templates/android/MapTemplate/` |
+| AppConfig | `MapTemplate/App/AppConfig.swift` | `app/src/main/kotlin/com/appship/map/AppConfig.kt` |
+| Mock Data | `MapTemplate/MockData/MockDataProvider.swift` | `app/src/main/kotlin/com/appship/map/mock/MockDataProvider.kt` |
+| Models | `MapTemplate/Models/Models.swift` | `app/src/main/kotlin/com/appship/map/data/model/` |
+| Features | `MapTemplate/Features/` | `app/src/main/kotlin/com/appship/map/features/` |
+
+**Docs:** README.md, ARCHITECTURE.md, API_INTEGRATION.md, CUSTOMIZATION.md
+
+---
+
+### DashTemplate -- Dashboard / Analytics App
+
+**One-line:** Dashboard app with customizable widget grid, charts, real-time metrics, and alert management.
+
+**Best match when:**
+- User wants a dashboard or analytics app
+- User mentions metrics, KPIs, charts, or monitoring
+- User is building an IoT controller, business dashboard, or admin panel
+- User wants real-time data visualization with drill-down
+
+**NOT a match when:**
+- User wants to track personal finance (use FinanceTemplate)
+- User wants a fitness dashboard (use HealthTemplate)
+- User wants a social analytics tool (use SocialTemplate)
+
+**Key features:**
+- Customizable widget grid with reorderable cards
+- Multiple chart types (line, bar, pie, donut, gauge, sparkline)
+- Real-time data updates with pull-to-refresh
+- KPI cards with trend indicators (up/down arrows, percentages)
+- Time range selector (today, week, month, year, custom range)
+- Alert and threshold notifications
+- Data drill-down (tap chart to see detail breakdown)
+- Export reports (PDF, CSV)
+- Multiple data sources with connection status
+- Dark mode optimized for data readability
+
+**Screens (iOS):**
+DashboardView, MetricDetailView, ChartDetailView, AlertsView, ReportsView, DataSourcesView, SettingsView
+
+**Screens (Android):**
+DashboardScreen, MetricDetailScreen, ChartDetailScreen, AlertsScreen, ReportsScreen, DataSourcesScreen, SettingsScreen, Navigation
+
+**Feature flags (AppConfig):**
+enableRealtime, enableAlerts, enableExport, enableCustomDashboard, enableWidgetReorder, enableDrillDown, enableDataSources, enableDarkModeDefault
+
+**File paths:**
+
+| | iOS | Android |
+|---|---|---|
+| Root | `templates/ios/DashTemplate/` | `templates/android/DashTemplate/` |
+| AppConfig | `DashTemplate/App/AppConfig.swift` | `app/src/main/kotlin/com/appship/dash/AppConfig.kt` |
+| Mock Data | `DashTemplate/MockData/MockDataProvider.swift` | `app/src/main/kotlin/com/appship/dash/mock/MockDataProvider.kt` |
+| Models | `DashTemplate/Models/Models.swift` | `app/src/main/kotlin/com/appship/dash/data/model/` |
+| Features | `DashTemplate/Features/` | `app/src/main/kotlin/com/appship/dash/features/` |
+
+**Docs:** README.md, ARCHITECTURE.md, API_INTEGRATION.md, CUSTOMIZATION.md
+
+---
+
+### FamilyTemplate -- Family / Kids / Parenting App
+
+**One-line:** Family organization app with member profiles, chore boards, shared calendar, rewards, and photo sharing.
+
+**Best match when:**
+- User wants a family organization or parenting app
+- User mentions chores, allowance, family calendar, or kids
+- User is building a baby milestone tracker, school planner, or family hub
+- User wants multi-user roles (parent/child) within the app
+
+**NOT a match when:**
+- User wants a general social network (use SocialTemplate)
+- User wants a personal task manager (use TaskTemplate)
+- User wants a photo-focused social app (use SocialTemplate)
+
+**Key features:**
+- Family member profiles with avatars and roles (parent, child, guardian)
+- Shared family calendar with events and reminders
+- Chore and task assignment with recurring schedules
+- Reward and points system with redeemable goals
+- Photo and memory sharing timeline
+- Location sharing between family members
+- Child-safe mode (simplified UI, restricted actions)
+- Parental controls and approval workflows
+- Milestone and growth tracking (for baby/toddler apps)
+- Emergency contact quick access
+- Family allowance and spending tracker
+
+**Screens (iOS):**
+FamilyHubView, MembersListView, MemberProfileView, ChoreBoardView, CalendarView, RewardsView, GalleryView, LocationMapView, SettingsView, OnboardingView
+
+**Screens (Android):**
+FamilyHubScreen, MembersListScreen, MemberProfileScreen, ChoreBoardScreen, CalendarScreen, RewardsScreen, GalleryScreen, LocationMapScreen, SettingsScreen, Navigation
+
+**Feature flags (AppConfig):**
+enableChores, enableRewards, enableCalendar, enablePhotoSharing, enableLocationSharing, enableChildMode, enableMilestones, enableAllowance, enableApprovalWorkflow
+
+**File paths:**
+
+| | iOS | Android |
+|---|---|---|
+| Root | `templates/ios/FamilyTemplate/` | `templates/android/FamilyTemplate/` |
+| AppConfig | `FamilyTemplate/App/AppConfig.swift` | `app/src/main/kotlin/com/appship/family/AppConfig.kt` |
+| Mock Data | `FamilyTemplate/MockData/MockDataProvider.swift` | `app/src/main/kotlin/com/appship/family/mock/MockDataProvider.kt` |
+| Models | `FamilyTemplate/Models/Models.swift` | `app/src/main/kotlin/com/appship/family/data/model/` |
+| Features | `FamilyTemplate/Features/` | `app/src/main/kotlin/com/appship/family/features/` |
+
+**Docs:** README.md, ARCHITECTURE.md, API_INTEGRATION.md, CUSTOMIZATION.md
+
+---
+
+### GameTemplate -- Casual Game / Gamified App
+
+**One-line:** Game shell with scoring, levels, achievements, leaderboard, in-game shop, and daily challenges.
+
+**Best match when:**
+- User wants a casual game (trivia, puzzle, word, card)
+- User mentions scores, levels, leaderboards, or achievements
+- User is building a brain training, quiz, or gamified loyalty app
+- User wants gamification patterns (XP, coins, power-ups)
+
+**NOT a match when:**
+- User wants a real-time action or 3D game (too specialized)
+- User wants a social app with game elements (use SocialTemplate + GamificationKit module)
+- User wants a fitness gamification app (use HealthTemplate + GamificationKit module)
+
+**Key features:**
+- Game session lifecycle (start, play, pause, end, results)
+- Score tracking with high-score persistence
+- Level and stage progression system
+- Achievement badges and milestones
+- In-game currency (coins/gems) with shop
+- Leaderboard (daily, weekly, all-time)
+- Lives/energy system with regeneration timers
+- Sound effects and haptic feedback
+- Game Center / Google Play Games integration
+- Daily challenges with streak bonuses
+- Tutorial and onboarding overlay
+- Multiplayer lobby (turn-based)
+
+**Screens (iOS):**
+HomeMenuView, GameView, ResultsView, LeaderboardView, ShopView, AchievementsView, ProfileView, SettingsView
+
+**Screens (Android):**
+HomeMenuScreen, GameScreen, ResultsScreen, LeaderboardScreen, ShopScreen, AchievementsScreen, ProfileScreen, SettingsScreen, Navigation
+
+**Feature flags (AppConfig):**
+enableLeaderboard, enableMultiplayer, enableShop, enableAchievements, enableDailyChallenge, enableLives, enableSoundEffects, enableGameCenter, enableTutorial
+
+**File paths:**
+
+| | iOS | Android |
+|---|---|---|
+| Root | `templates/ios/GameTemplate/` | `templates/android/GameTemplate/` |
+| AppConfig | `GameTemplate/App/AppConfig.swift` | `app/src/main/kotlin/com/appship/game/AppConfig.kt` |
+| Mock Data | `GameTemplate/MockData/MockDataProvider.swift` | `app/src/main/kotlin/com/appship/game/mock/MockDataProvider.kt` |
+| Models | `GameTemplate/Models/Models.swift` | `app/src/main/kotlin/com/appship/game/data/model/` |
+| Features | `GameTemplate/Features/` | `app/src/main/kotlin/com/appship/game/features/` |
+
+**Docs:** README.md, ARCHITECTURE.md, API_INTEGRATION.md, CUSTOMIZATION.md
+
+---
+
+### ReferenceTemplate -- Integration Reference (Internal)
+
+**One-line:** Kitchen-sink app integrating all shared modules for testing and agent reference.
+
+**NOT for user apps.** This template exists solely as:
+- An integration reference for the AI agent (shows how every shared module is wired in)
+- A build regression target (CI compiles after any module or template change)
+- A Maestro test regression target (all module flows tested in a real app context)
+
+Domain: "Daily Companion" personal organizer. See `ReferenceTemplate/INTEGRATION_MAP.md` for module-to-file mapping.
+
+---
+
+## Shared Modules
+
+All templates can be enhanced with **shared modules** from `templates/shared/`. See `templates/shared/MODULES_CATALOG.md` for the full module index with keywords, platforms, dependencies, and integration instructions.
+
+### How Modules Work
+
+All 49 modules are available and selected by keyword matching against the user's app description. No modules are auto-included — the agent selects only the modules that genuinely match the app's features (typically 5-15 per app).
+
+Modules are **reference implementations**. The agent reads their source files from `templates/shared/` and writes adapted code into the app, adjusting imports, package names, and AppConfig references to fit the target project.
+
+### Module Integration
+
+Each module has an `INTEGRATION.md` file with:
+1. **AppConfig additions** — feature flags to add
+2. **Navigation wiring** — where to add navigation entries
+3. **String merge** — strings to add to the app's centralized string system
+4. **Test IDs** — accessibility identifiers for Maestro testing
+
+The `module-selector` skill runs in Step 0 (parallel with template and brand selection) to determine which modules to include. The `module-integrator` skill in Step 4 reads the module references and writes adapted code into the app.
+
+### Module Files (per module)
+
+| Platform | Files |
+|----------|-------|
+| iOS | `{Module}View.swift`, `{Module}Service.swift`, `Strings.swift`, `INTEGRATION.md` |
+| Android | `{Module}Screen.kt`, `{Module}Manager.kt`, `strings.xml` |
+| Tests | `{Module}Tests.swift` (XCTest), `{Module}Test.kt` (JUnit), `{module}_flow.yaml` (Maestro) |
+
+---
+
+## Template Selection Guide
+
+Use the following decision flow to pick the right template:
+
+1. **Does the app involve buying or selling products?** --> ShopTemplate
+2. **Does the app track daily habits, routines, or personal progress?** --> TrackTemplate
+3. **Does the app book appointments, schedule services, or make reservations?** --> BookTemplate
+4. **Is the app a social feed with posts, stories, and follower relationships?** --> SocialTemplate
+5. **Does the app manage money, budgets, expenses, or financial goals?** --> FinanceTemplate
+6. **Is the app primarily about messaging, chat, or real-time communication?** --> ChatTemplate
+7. **Does the app teach courses, quizzes, flashcards, or structured learning?** --> LearnTemplate
+8. **Does the app track workouts, nutrition, health metrics, or fitness?** --> HealthTemplate
+9. **Does the app manage tasks, projects, to-do lists, or kanban boards?** --> TaskTemplate
+10. **Does the app play audio, video, podcasts, or stream content?** --> MediaTemplate
+11. **Is the app centered on a map with places, directions, or location discovery?** --> MapTemplate
+12. **Does the app show dashboards, charts, metrics, or analytics?** --> DashTemplate
+13. **Is the app for families with chores, shared calendars, or parenting features?** --> FamilyTemplate
+14. **Is the app a casual game with scores, levels, leaderboards, or achievements?** --> GameTemplate
+
+### Hybrid Apps
+
+When an app spans multiple categories, pick the template closest to the **primary user flow** and add features from other templates:
+
+| User's Primary Need | Secondary Need | Start With | Borrow From |
+|---|---|---|---|
+| Social feed + messaging | Chat is secondary to feed | SocialTemplate | ChatTemplate (messaging UI) |
+| Messaging + social profiles | Chat is the main activity | ChatTemplate | SocialTemplate (profile screens) |
+| E-commerce + social features | Selling is the core | ShopTemplate | SocialTemplate (feed, reviews) |
+| Booking + payments | Booking is the core | BookTemplate | ShopTemplate (checkout flow) |
+| Finance + habit tracking | Money is the focus | FinanceTemplate | TrackTemplate (streak/goal UI) |
+| Habit tracking + social | Tracking is the focus | TrackTemplate | SocialTemplate (sharing, feed) |
+| Education + gamification | Learning is the focus | LearnTemplate | GameTemplate (scores, leaderboard) |
+| Fitness + social community | Workouts are the focus | HealthTemplate | SocialTemplate (feed, profiles) |
+| Task management + calendar | Tasks are the focus | TaskTemplate | BookTemplate (calendar UI) |
+| Recipe/cookbook + media | Content consumption | MediaTemplate | ShopTemplate (categories, search) |
+| Delivery tracking + map | Location is primary | MapTemplate | ChatTemplate (real-time updates) |
+| IoT dashboard + controls | Monitoring is primary | DashTemplate | MapTemplate (device locations) |
+| Family + finance | Family organization | FamilyTemplate | FinanceTemplate (allowance tracking) |
+| Quiz game + education | Gaming is primary | GameTemplate | LearnTemplate (quiz engine) |
+| Fitness + gamification | Health tracking + game | HealthTemplate | GameTemplate (XP, achievements) |
+| Travel guide + map | Places are primary | MapTemplate | BookTemplate (reservations) |
+
+### When No Template Fits
+
+If the user's app idea does not match any template well, pick the template with the **most similar navigation and screen patterns**, then customize heavily. The templates provide:
+- Pre-built navigation (tabs, stacks)
+- Authentication flow
+- Settings and profile screens
+- Mock data system
+- Theming infrastructure
+
+These are valuable even when the specific feature screens need replacement.
+
+---
+
+## Shared Architecture
+
+All 14 templates share these patterns:
+
+### Architecture
+- **Pattern:** MVVM (Model-View-ViewModel)
+- **iOS:** SwiftUI, iOS 16+, Swift 5.9+, async/await, Combine
+- **Android:** Jetpack Compose, API 26+, Kotlin Coroutines + Flow, Hilt DI, Material Design 3
+
+### Customization System
+All templates use `// CUSTOMIZE:` comment markers in code:
+- `// CUSTOMIZE:BRANDING` -- App name, bundle ID, version
+- `// CUSTOMIZE:FEATURES` -- Feature toggle flags
+- `// CUSTOMIZE:API` -- Backend endpoint URLs
+- `// CUSTOMIZE:BUSINESS` -- Business rules (pricing, limits, policies)
+- `// CUSTOMIZE:CONTENT` -- Support URLs, legal links, app copy
+- `// CUSTOMIZE:THEME` -- Colors, typography, spacing
+- `// CUSTOMIZE:ONBOARDING` -- Onboarding slide content
+- `// CUSTOMIZE:CATEGORIES` -- Category lists (where applicable)
+
+### Central Configuration
+Every template has one `AppConfig` file that centralizes all configuration:
+- **iOS:** `AppConfig.swift` (static struct properties)
+- **Android:** `AppConfig.kt` (Kotlin object with const vals)
+
+### Mock Data
+Every template ships with `MockDataProvider` containing realistic sample data. Replace with real API calls by searching for `// CUSTOMIZE:API` markers.
+
+### Per-Template Documentation
+Each template directory contains:
+- `README.md` -- Overview, features, quick start, project structure
+- `ARCHITECTURE.md` -- Technical architecture with Mermaid diagrams, data models, state management
+- `API_INTEGRATION.md` -- Backend integration guide, endpoint mapping, request/response formats
+- `CUSTOMIZATION.md` -- All customization options, presets, feature toggles, theme configuration
+
+### Quick Start Process (for agents)
+1. Copy the selected template to the user's project location
+2. Update `AppConfig` with the user's app identity (name, bundle ID, branding)
+3. Adjust feature flags to match requirements
+4. Replace mock data with API integration
+5. Customize theme colors and content
+6. Test and verify functionality