@shaykec/app-agent 1.0.4 → 1.0.5

package/templates/android/TaskTemplate/app/src/main/kotlin/com/appship/task/features/kanban/KanbanBoardScreen.kt

@@ -43,7 +43,9 @@ fun KanbanColumn(
     column: com.appship.task.data.KanbanColumn,
     modifier: Modifier = Modifier
 ) {
-    val tasks = MockDataProvider.tasks.value.filter { column.taskIds.contains(it.id) }
+    val repository = remember { DataSourceResolver.repository }
+    val tasks by repository.tasks.collectAsState()
+    val columnTasks = tasks.filter { column.taskIds.contains(it.id) }
     
     Column(modifier = modifier) {
         Card(modifier = Modifier.fillMaxWidth()) {
@@ -56,7 +58,7 @@ fun KanbanColumn(
                     style = MaterialTheme.typography.titleMedium
                 )
                 Text(
-                    text = "${tasks.size} tasks",
+                    text = "${columnTasks.size} tasks",
                     style = MaterialTheme.typography.bodySmall
                 )
             }
@@ -67,7 +69,7 @@ fun KanbanColumn(
         LazyColumn(
             verticalArrangement = Arrangement.spacedBy(8.dp)
         ) {
-            itemsIndexed(tasks) { index, task ->
+            itemsIndexed(columnTasks) { index, task ->
                 KanbanTaskCard(
                     task = task,
                     modifier = Modifier.testTag("kanban_task_${index}_card")

package/templates/android/TaskTemplate/app/src/main/kotlin/com/appship/task/features/projects/ProjectDetailScreen.kt

@@ -21,10 +21,14 @@ fun ProjectDetailScreen(
     onBack: () -> Unit = {},
     onTaskClick: (String) -> Unit = {}
 ) {
-    val project = MockDataProvider.projects.value.firstOrNull { it.id == projectId }
-    val tasks = MockDataProvider.tasks.value
-        .filter { project?.tasks?.contains(it.id) == true }
-        .sortedByDescending { !it.isCompleted }
+    val repository = remember { DataSourceResolver.repository }
+    val projects by repository.projects.collectAsState()
+    val tasks by repository.tasks.collectAsState()
+    val project = remember(projects) { projects.firstOrNull { it.id == projectId } }
+    val projectTasks = remember(project, tasks) {
+        tasks.filter { project?.tasks?.contains(it.id) == true }
+            .sortedByDescending { !it.isCompleted }
+    }
     
     Scaffold(
         topBar = {
@@ -45,7 +49,7 @@ fun ProjectDetailScreen(
             contentPadding = PaddingValues(16.dp),
             verticalArrangement = Arrangement.spacedBy(8.dp)
         ) {
-            itemsIndexed(tasks) { index, task ->
+            itemsIndexed(projectTasks) { index, task ->
                 TaskCard(
                     task = task,
                     onClick = { onTaskClick(task.id) },

package/templates/android/TaskTemplate/app/src/main/kotlin/com/appship/task/features/projects/ProjectListScreen.kt

@@ -58,9 +58,11 @@ fun ProjectCard(
     onClick: () -> Unit,
     modifier: Modifier = Modifier
 ) {
-    val tasks = MockDataProvider.tasks.value.filter { project.tasks.contains(it.id) }
-    val completedCount = tasks.count { it.isCompleted }
-    val progress = if (tasks.isEmpty()) 0.0 else completedCount.toDouble() / tasks.size
+    val repository = remember { DataSourceResolver.repository }
+    val tasks by repository.tasks.collectAsState()
+    val projectTasks = tasks.filter { project.tasks.contains(it.id) }
+    val completedCount = projectTasks.count { it.isCompleted }
+    val progress = if (projectTasks.isEmpty()) 0.0 else completedCount.toDouble() / projectTasks.size
     
     Card(
         onClick = onClick,
@@ -90,7 +92,7 @@ fun ProjectCard(
                     )
                 }
                 Text(
-                    text = "$completedCount of ${tasks.size} tasks",
+                    text = "$completedCount of ${projectTasks.size} tasks",
                     style = MaterialTheme.typography.bodySmall,
                     color = MaterialTheme.colorScheme.onSurfaceVariant
                 )

package/templates/android/TaskTemplate/app/src/main/kotlin/com/appship/task/features/search/SearchScreen.kt

@@ -8,7 +8,7 @@ import androidx.compose.runtime.*
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.unit.dp
-import com.appship.task.mock.MockDataProvider
+import com.appship.task.data.DataSourceResolver
 
 @OptIn(ExperimentalMaterial3Api::class)
 @Composable

package/templates/android/TaskTemplate/app/src/main/kotlin/com/appship/task/features/tasks/TaskDetailScreen.kt

@@ -9,7 +9,6 @@ import androidx.compose.ui.Modifier
 import androidx.compose.ui.platform.testTag
 import androidx.compose.ui.unit.dp
 import com.appship.task.data.TaskPriority
-import com.appship.task.mock.MockDataProvider
 
 @OptIn(ExperimentalMaterial3Api::class)
 @Composable

package/templates/android/TaskTemplate/app/src/main/kotlin/com/appship/task/mock/MockDataProvider.kt

@@ -1,13 +1,14 @@
 package com.appship.task.mock
 
 import com.appship.task.data.*
+import com.appship.task.data.DataRepository
 import kotlinx.coroutines.flow.MutableStateFlow
 import kotlinx.coroutines.flow.StateFlow
 import kotlinx.coroutines.flow.asStateFlow
 import java.time.LocalDate
 import java.time.LocalDateTime
 
-object MockDataProvider {
+object MockDataProvider : DataRepository {
     
     private val _tasks = MutableStateFlow<List<Task>>(emptyList())
     val tasks: StateFlow<List<Task>> = _tasks.asStateFlow()
@@ -294,22 +295,22 @@ object MockDataProvider {
     
     // MARK: - CRUD Operations
     
-    fun getTasks(): List<Task> = _tasks.value
+    override fun getTasks(): List<Task> = _tasks.value
     
-    fun getTask(id: String): Task? = _tasks.value.firstOrNull { it.id == id }
+    override fun getTask(id: String): Task? = _tasks.value.firstOrNull { it.id == id }
     
-    fun createTask(task: Task) {
+    override fun createTask(task: Task) {
         _tasks.value = _tasks.value + task
         if (task.projectId != null) {
             updateProjectTasks(projectId = task.projectId, taskId = task.id, add = true)
         }
     }
     
-    fun updateTask(task: Task) {
+    override fun updateTask(task: Task) {
         _tasks.value = _tasks.value.map { if (it.id == task.id) task else it }
     }
     
-    fun deleteTask(id: String) {
+    override fun deleteTask(id: String) {
         val task = _tasks.value.firstOrNull { it.id == id }
         if (task != null && task.projectId != null) {
             updateProjectTasks(projectId = task.projectId, taskId = id, add = false)
@@ -321,21 +322,21 @@ object MockDataProvider {
         }
     }
     
-    fun getProjects(): List<Project> = _projects.value
+    override fun getProjects(): List<Project> = _projects.value
     
-    fun getProject(id: String): Project? = _projects.value.firstOrNull { it.id == id }
+    override fun getProject(id: String): Project? = _projects.value.firstOrNull { it.id == id }
     
-    fun getTasksByTag(tagId: String): List<Task> {
+    override fun getTasksByTag(tagId: String): List<Task> {
         return _tasks.value.filter { it.tags.contains(tagId) }
     }
     
-    fun getTasksByDueDate(date: LocalDate): List<Task> {
+    override fun getTasksByDueDate(date: LocalDate): List<Task> {
         return _tasks.value.filter { it.dueDate == date }
     }
     
-    fun getKanbanColumns(): List<KanbanColumn> = _kanbanColumns.value
+    override fun getKanbanColumns(): List<KanbanColumn> = _kanbanColumns.value
     
-    fun moveTaskToColumn(taskId: String, columnId: String) {
+    override fun moveTaskToColumn(taskId: String, columnId: String) {
         // Remove from all columns
         _kanbanColumns.value = _kanbanColumns.value.map { column ->
             column.copy(taskIds = column.taskIds.filter { it != taskId })

package/templates/android/TrackTemplate/app/src/main/kotlin/com/appship/track/AppConfig.kt

@@ -71,4 +71,13 @@ object AppConfig {
         0xFFDDA0DD, 0xFF98D8C8, 0xFFF7DC6F, 0xFFBB8FCE, 0xFF85C1E9,
         0xFFF8B500, 0xFFFF7F50, 0xFF6B5B95, 0xFF88B04B, 0xFFF7CAC9
     ).map { Color(it) }
+    
+    // CUSTOMIZE:DATASOURCE - Data source configuration
+    object DataSource {
+        enum class SourceType {
+            LOCAL_STORAGE,  // Room — real local database (DEFAULT)
+            MOCK            // In-memory seed data — for development/testing only
+        }
+        val active: SourceType = SourceType.MOCK
+    }
 }

package/templates/android/TrackTemplate/app/src/main/kotlin/com/appship/track/data/DataRepository.kt

@@ -0,0 +1,34 @@
+package com.appship.track.data
+
+import kotlinx.coroutines.flow.StateFlow
+import java.time.LocalDate
+
+/**
+ * Abstracts the data layer. Both MockDataProvider and LocalStorageProvider
+ * implement this, allowing the app to swap data sources via AppConfig.DataSource.active.
+ *
+ * Screens and ViewModels depend on this interface rather than on a concrete implementation.
+ * Use [DataSourceResolver.repository] to get the active provider.
+ */
+interface DataRepository {
+    // Observable state
+    val habits: StateFlow<List<Habit>>
+    val achievements: StateFlow<List<Achievement>>
+    
+    // Legacy accessors for backward compatibility
+    val sampleHabits: List<Habit>
+    val achievementsList: List<Achievement>
+    
+    // CRUD Operations for Habits
+    fun createHabit(habit: Habit)
+    fun updateHabit(habitId: String, update: (Habit) -> Habit)
+    fun deleteHabit(habitId: String)
+    fun archiveHabit(habitId: String, archived: Boolean = true)
+    fun toggleHabitCompletion(habitId: String, date: LocalDate, completed: Boolean)
+    
+    // CRUD Operations for Achievements
+    fun updateAchievementProgress(achievementId: String, progress: Int, isUnlocked: Boolean = false)
+    
+    // Reset
+    fun reset()
+}

package/templates/android/TrackTemplate/app/src/main/kotlin/com/appship/track/data/DataSourceResolver.kt

@@ -0,0 +1,23 @@
+package com.appship.track.data
+
+import com.appship.track.AppConfig
+import com.appship.track.mock.MockDataProvider
+
+/**
+ * Resolves the active [DataRepository] implementation based on [AppConfig.DataSource.active].
+ * Screens use this to obtain the correct data source without knowing the concrete type.
+ *
+ * Usage:
+ *   val repository = DataSourceResolver.repository
+ *   val habits by repository.habits.collectAsState()
+ */
+object DataSourceResolver {
+    val repository: DataRepository
+        get() = when (AppConfig.DataSource.active) {
+            AppConfig.DataSource.SourceType.LOCAL_STORAGE -> {
+                // TODO: Return LocalStorageProvider once implemented
+                MockDataProvider
+            }
+            AppConfig.DataSource.SourceType.MOCK -> MockDataProvider
+        }
+}

package/templates/android/TrackTemplate/app/src/main/kotlin/com/appship/track/features/achievements/AchievementsViewModel.kt

@@ -3,7 +3,7 @@ package com.appship.track.features.achievements
 import androidx.lifecycle.ViewModel
 import androidx.lifecycle.viewModelScope
 import com.appship.track.data.Achievement
-import com.appship.track.mock.MockDataProvider
+import com.appship.track.data.DataSourceResolver
 import dagger.hilt.android.lifecycle.HiltViewModel
 import kotlinx.coroutines.flow.MutableStateFlow
 import kotlinx.coroutines.flow.StateFlow
@@ -22,6 +22,8 @@ data class AchievementsUiState(
 @HiltViewModel
 class AchievementsViewModel @Inject constructor() : ViewModel() {
     
+    private val repository = DataSourceResolver.repository
+    
     private val _uiState = MutableStateFlow(AchievementsUiState())
     val uiState: StateFlow<AchievementsUiState> = _uiState.asStateFlow()
     
@@ -31,7 +33,7 @@ class AchievementsViewModel @Inject constructor() : ViewModel() {
     
     private fun loadAchievements() {
         viewModelScope.launch {
-            val achievements = MockDataProvider.achievements.value
+            val achievements = repository.achievements.value
             val unlocked = achievements.filter { it.isUnlocked }
             val locked = achievements.filter { !it.isUnlocked }
             

package/templates/android/TrackTemplate/app/src/main/kotlin/com/appship/track/features/dashboard/TodayViewModel.kt

@@ -3,7 +3,7 @@ package com.appship.track.features.dashboard
 import androidx.lifecycle.ViewModel
 import androidx.lifecycle.viewModelScope
 import com.appship.track.data.*
-import com.appship.track.mock.MockDataProvider
+import com.appship.track.data.DataSourceResolver
 import dagger.hilt.android.lifecycle.HiltViewModel
 import kotlinx.coroutines.flow.MutableStateFlow
 import kotlinx.coroutines.flow.StateFlow
@@ -27,6 +27,8 @@ data class TodayUiState(
 @HiltViewModel
 class TodayViewModel @Inject constructor() : ViewModel() {
     
+    private val repository = DataSourceResolver.repository
+    
     private val _uiState = MutableStateFlow(TodayUiState())
     val uiState: StateFlow<TodayUiState> = _uiState.asStateFlow()
     
@@ -40,7 +42,7 @@ class TodayViewModel @Inject constructor() : ViewModel() {
     private fun loadData() {
         viewModelScope.launch {
             habits.clear()
-            habits.addAll(MockDataProvider.sampleHabits)
+            habits.addAll(repository.sampleHabits)
             updateDailySummary()
         }
     }

package/templates/android/TrackTemplate/app/src/main/kotlin/com/appship/track/features/habits/HabitDetailViewModel.kt

@@ -2,8 +2,8 @@ package com.appship.track.features.habits
 
 import androidx.lifecycle.ViewModel
 import androidx.lifecycle.viewModelScope
+import com.appship.track.data.DataSourceResolver
 import com.appship.track.data.Habit
-import com.appship.track.mock.MockDataProvider
 import dagger.hilt.android.lifecycle.HiltViewModel
 import kotlinx.coroutines.flow.MutableStateFlow
 import kotlinx.coroutines.flow.StateFlow
@@ -25,12 +25,14 @@ data class HabitDetailUiState(
 @HiltViewModel
 class HabitDetailViewModel @Inject constructor() : ViewModel() {
     
+    private val repository = DataSourceResolver.repository
+    
     private val _uiState = MutableStateFlow(HabitDetailUiState())
     val uiState: StateFlow<HabitDetailUiState> = _uiState.asStateFlow()
     
     fun loadHabit(habitId: String) {
         viewModelScope.launch {
-            val habit = MockDataProvider.sampleHabits.find { it.id == habitId }
+            val habit = repository.sampleHabits.find { it.id == habitId }
             
             if (habit != null) {
                 // Generate random stats for demo

package/templates/android/TrackTemplate/app/src/main/kotlin/com/appship/track/features/habits/HabitsListViewModel.kt

@@ -2,8 +2,8 @@ package com.appship.track.features.habits
 
 import androidx.lifecycle.ViewModel
 import androidx.lifecycle.viewModelScope
+import com.appship.track.data.DataSourceResolver
 import com.appship.track.data.Habit
-import com.appship.track.mock.MockDataProvider
 import dagger.hilt.android.lifecycle.HiltViewModel
 import kotlinx.coroutines.flow.MutableStateFlow
 import kotlinx.coroutines.flow.StateFlow
@@ -22,6 +22,8 @@ data class HabitsListUiState(
 @HiltViewModel
 class HabitsListViewModel @Inject constructor() : ViewModel() {
     
+    private val repository = DataSourceResolver.repository
+    
     private val _uiState = MutableStateFlow(HabitsListUiState())
     val uiState: StateFlow<HabitsListUiState> = _uiState.asStateFlow()
     
@@ -34,7 +36,7 @@ class HabitsListViewModel @Inject constructor() : ViewModel() {
     private fun loadHabits() {
         viewModelScope.launch {
             allHabits.clear()
-            allHabits.addAll(MockDataProvider.sampleHabits)
+            allHabits.addAll(repository.sampleHabits)
             
             // Generate random streaks
             val streaks = allHabits.associate { it.id to (1..21).random() }

package/templates/android/TrackTemplate/app/src/main/kotlin/com/appship/track/mock/MockDataProvider.kt

@@ -1,12 +1,14 @@
 package com.appship.track.mock
 
 import com.appship.track.data.*
+import com.appship.track.data.DataRepository
 import kotlinx.coroutines.flow.MutableStateFlow
 import kotlinx.coroutines.flow.StateFlow
 import kotlinx.coroutines.flow.asStateFlow
+import java.time.LocalDate
 import java.time.LocalDateTime
 
-object MockDataProvider {
+object MockDataProvider : DataRepository {
     
     private val defaultHabits = listOf(
         Habit(
@@ -153,17 +155,17 @@ object MockDataProvider {
     )
     
     private val _habits = MutableStateFlow(defaultHabits)
-    val habits: StateFlow<List<Habit>> = _habits.asStateFlow()
+    override val habits: StateFlow<List<Habit>> = _habits.asStateFlow()
     
     private val _achievements = MutableStateFlow(defaultAchievements)
-    val achievements: StateFlow<List<Achievement>> = _achievements.asStateFlow()
+    override val achievements: StateFlow<List<Achievement>> = _achievements.asStateFlow()
     
     // Legacy accessors for backward compatibility
-    val sampleHabits: List<Habit> get() = _habits.value
-    val achievementsList: List<Achievement> get() = _achievements.value
+    override val sampleHabits: List<Habit> get() = _habits.value
+    override val achievementsList: List<Achievement> get() = _achievements.value
     
     // CRUD Operations for Habits
-    fun createHabit(habit: Habit) {
+    override fun createHabit(habit: Habit) {
         _habits.value = _habits.value + habit
         SyncManager.incrementPending()
     }
@@ -173,23 +175,23 @@ object MockDataProvider {
         SyncManager.incrementPending()
     }
     
-    fun deleteHabit(habitId: String) {
+    override fun deleteHabit(habitId: String) {
         _habits.value = _habits.value.filter { it.id != habitId }
         SyncManager.incrementPending()
     }
     
-    fun archiveHabit(habitId: String, archived: Boolean = true) {
+    override fun archiveHabit(habitId: String, archived: Boolean = true) {
         updateHabit(habitId) { it.copy(isArchived = archived) }
     }
     
-    fun toggleHabitCompletion(habitId: String, date: java.time.LocalDate, completed: Boolean) {
+    override fun toggleHabitCompletion(habitId: String, date: LocalDate, completed: Boolean) {
         // This is a placeholder - actual implementation would work with HabitEntry
         // For now, we'll just mark it as a pending sync operation
         SyncManager.incrementPending()
     }
     
     // CRUD Operations for Achievements
-    fun updateAchievementProgress(achievementId: String, progress: Int, isUnlocked: Boolean = false) {
+    override fun updateAchievementProgress(achievementId: String, progress: Int, isUnlocked: Boolean = false) {
         _achievements.value = _achievements.value.map {
             if (it.id == achievementId) {
                 it.copy(
@@ -202,7 +204,7 @@ object MockDataProvider {
         SyncManager.incrementPending()
     }
     
-    fun reset() {
+    override fun reset() {
         _habits.value = defaultHabits
         _achievements.value = defaultAchievements
         SyncManager.resetPending()

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

@@ -87,4 +87,13 @@ struct AppConfig {
             ("Share", "Send photos, videos, and voice messages", "photo.on.rectangle")
         ]
     }
+    
+    // CUSTOMIZE:DATASOURCE - Data source configuration
+    struct DataSource {
+        enum SourceType {
+            case localStorage   // Core Data — real local database (DEFAULT)
+            case mock           // In-memory seed data — for development/testing only
+        }
+        static let active: SourceType = .mock
+    }
 }

package/templates/ios/ChatTemplate/ChatTemplate/Data/DataRepository.swift

@@ -0,0 +1,43 @@
+import Foundation
+
+/// Protocol abstracting the data layer. Both MockDataProvider and LocalStorageProvider
+/// conform to this, allowing the app to swap data sources via AppConfig.DataSource.active.
+///
+/// ViewModels depend on this protocol (via `any DataRepository`) rather than on a concrete
+/// implementation. Use `DataSourceResolver.repository` to get the active provider.
+protocol DataRepository: AnyObject {
+    // MARK: - Observable State
+    
+    var currentUser: User { get }
+    var users: [User] { get }
+    var conversations: [Conversation] { get }
+    var messages: [String: [Message]] { get }
+    var calls: [Call] { get }
+    var contacts: [Contact] { get }
+    
+    // MARK: - CRUD Operations - Messages
+    
+    func sendMessage(_ message: Message)
+    
+    // MARK: - CRUD Operations - Conversations
+    
+    func createConversation(_ conversation: Conversation)
+    func deleteConversation(_ conversation: Conversation)
+    func pinConversation(_ conversation: Conversation)
+    func unpinConversation(_ conversation: Conversation)
+    func muteConversation(_ conversation: Conversation)
+    func unmuteConversation(_ conversation: Conversation)
+    func markMessagesAsRead(conversationId: String)
+    
+    // MARK: - CRUD Operations - Calls
+    
+    func addCall(_ call: Call)
+    
+    // MARK: - Helper Functions
+    
+    func getMessages(for conversationId: String) -> [Message]
+    
+    // MARK: - Reset
+    
+    func reset()
+}

package/templates/ios/ChatTemplate/ChatTemplate/Data/DataSourceResolver.swift

@@ -0,0 +1,20 @@
+import Foundation
+
+/// Resolves the active DataRepository implementation based on AppConfig.DataSource.active.
+/// ViewModels use this to obtain the correct data source without knowing the concrete type.
+///
+/// Usage:
+///   let repo = DataSourceResolver.repository
+///   let conversations = repo.conversations
+enum DataSourceResolver {
+    /// Returns the active DataRepository based on the current configuration.
+    static var repository: any DataRepository {
+        switch AppConfig.DataSource.active {
+        case .localStorage:
+            // TODO: Return LocalStorageProvider.shared once implemented
+            return MockDataProvider.shared
+        case .mock:
+            return MockDataProvider.shared
+        }
+    }
+}

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

@@ -99,4 +99,13 @@ struct AppConfig {
             ("Smart Alerts", "Get notified when metrics exceed thresholds", "bell.badge.fill")
         ]
     }
+    
+    // CUSTOMIZE:DATASOURCE - Data source configuration
+    struct DataSource {
+        enum SourceType {
+            case localStorage   // Core Data — real local database (DEFAULT)
+            case mock           // In-memory seed data — for development/testing only
+        }
+        static let active: SourceType = .mock
+    }
 }

package/templates/ios/DashTemplate/DashTemplate/Data/DataRepository.swift

@@ -0,0 +1,53 @@
+import Foundation
+
+/// Protocol abstracting the data layer. Both MockDataProvider and LocalStorageProvider
+/// conform to this, allowing the app to swap data sources via AppConfig.DataSource.active.
+///
+/// ViewModels depend on this protocol (via `any DataRepository`) rather than on a concrete
+/// implementation. Use `DataSourceResolver.repository` to get the active provider.
+protocol DataRepository: AnyObject {
+    // MARK: - Observable State
+    
+    var widgets: [Widget] { get }
+    var metrics: [Metric] { get }
+    var alerts: [Alert] { get }
+    var reports: [Report] { get }
+    var dataSources: [DataSource] { get }
+    
+    var unreadAlertsCount: Int { get }
+    
+    // MARK: - Data Loading
+    
+    func loadData()
+    
+    // MARK: - CRUD Operations - Widgets
+    
+    func addWidget(_ widget: Widget)
+    func updateWidget(_ widget: Widget)
+    func deleteWidget(_ widget: Widget)
+    func reorderWidgets(from source: IndexSet, to destination: Int)
+    
+    // MARK: - CRUD Operations - Metrics
+    
+    func addMetric(_ metric: Metric)
+    func updateMetric(_ metric: Metric)
+    func deleteMetric(_ metric: Metric)
+    
+    // MARK: - CRUD Operations - Alerts
+    
+    func addAlert(_ alert: Alert)
+    func markAlertAsRead(_ alert: Alert)
+    func deleteAlert(_ alert: Alert)
+    func dismissAlert(_ alert: Alert)
+    
+    // MARK: - CRUD Operations - Reports
+    
+    func addReport(_ report: Report)
+    func deleteReport(_ report: Report)
+    
+    // MARK: - CRUD Operations - Data Sources
+    
+    func addDataSource(_ dataSource: DataSource)
+    func updateDataSource(_ dataSource: DataSource)
+    func deleteDataSource(_ dataSource: DataSource)
+}

package/templates/ios/DashTemplate/DashTemplate/MockData/MockDataProvider.swift

@@ -1,7 +1,7 @@
 import SwiftUI
 import Combine
 
-class MockDataProvider: ObservableObject {
+class MockDataProvider: ObservableObject, DataRepository {
     static let shared = MockDataProvider()
     
     // MARK: - Published Mutable State

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

@@ -78,6 +78,15 @@ struct AppConfig {
             ("Share Moments", "Capture and share family memories", "photo.fill")
         ]
     }
+    
+    // CUSTOMIZE:DATASOURCE - Data source configuration
+    struct DataSource {
+        enum SourceType {
+            case localStorage   // Core Data — real local database (DEFAULT)
+            case mock           // In-memory seed data — for development/testing only
+        }
+        static let active: SourceType = .mock
+    }
 }
 
 // MARK: - App State

package/templates/ios/FamilyTemplate/FamilyTemplate/App/FamilyTemplateApp.swift

@@ -4,7 +4,9 @@ import SwiftUI
 @main
 struct FamilyTemplateApp: App {
     @StateObject private var appState = AppState()
-    @StateObject private var dataProvider = MockDataProvider.shared
+    @StateObject private var dataProvider: MockDataProvider = {
+        DataSourceResolver.repository as! MockDataProvider
+    }()
     
     var body: some Scene {
         WindowGroup {
@@ -35,5 +37,5 @@ struct ContentView: View {
 #Preview {
     ContentView()
         .environmentObject(AppState())
-        .environmentObject(MockDataProvider.shared)
+        .environmentObject(DataSourceResolver.repository as! MockDataProvider)
 }

package/templates/ios/FamilyTemplate/FamilyTemplate/MockData/MockDataProvider.swift

@@ -4,7 +4,7 @@ import Combine
 
 // MARK: - Mock Data Provider
 // CUSTOMIZE:API - Replace mock data with real data source
-class MockDataProvider: ObservableObject {
+class MockDataProvider: ObservableObject, DataRepository {
     static let shared = MockDataProvider()
     
     // MARK: - Published Properties

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

@@ -33,6 +33,15 @@ struct AppConfig {
         static let termsURL = "https://example.com/terms"
     }
     
+    // CUSTOMIZE:DATASOURCE - Data source configuration
+    struct DataSource {
+        enum SourceType {
+            case localStorage   // Core Data — real local database (DEFAULT)
+            case mock           // In-memory seed data — for development/testing only
+        }
+        static let active: SourceType = .mock
+    }
+    
     // CUSTOMIZE:THEME
     struct Theme {
         static let primaryColor = Color(hex: "10B981") // Green