@shaykec/app-agent 1.0.4 → 1.0.6

package/templates/android/DashTemplate/tests/02_tab_navigation.yaml

@@ -1,19 +1,53 @@
 appId: ${APP_PACKAGE_NAME}
 ---
+- clearState
 - launchApp
-- tapOn:
-    id: "tab_bar_dashboard"
+- extendedWaitUntil:
+    visible:
+      id: "dashboard_time_range_picker"
+    timeout: 5000
+- assertVisible:
+    id: "dashboard_time_range_picker"
 - assertVisible:
-    id: "dashboard_widget_0_card"
+    text: "Dashboard"
 - tapOn:
-    id: "tab_bar_alerts"
+    text: "Alerts"
+- extendedWaitUntil:
+    visible:
+      id: "alert_0_card"
+    timeout: 3000
+    optional: true
 - assertVisible:
     id: "alert_0_card"
+    optional: true
+- assertVisible:
+    id: "alerts_empty_state"
+    optional: true
+- assertVisible:
+    text: "Alerts"
 - tapOn:
-    id: "tab_bar_settings"
+    text: "Settings"
+- extendedWaitUntil:
+    visible:
+      text: "Settings"
+    timeout: 3000
+- assertVisible:
+    text: "Settings"
+- tapOn:
+    text: "Dashboard"
+- extendedWaitUntil:
+    visible:
+      id: "dashboard_time_range_picker"
+    timeout: 3000
+- assertVisible:
+    id: "dashboard_time_range_picker"
 - assertVisible:
     text: "Dashboard"
 - tapOn:
-    id: "tab_bar_dashboard"
+    text: "Alerts"
+- extendedWaitUntil:
+    visible:
+      text: "Alerts"
+    timeout: 3000
 - assertVisible:
-    id: "dashboard_widget_0_card"
+    text: "Alerts"

package/templates/android/FamilyTemplate/TESTING_MANIFEST.md

@@ -19,6 +19,9 @@ This document catalogs all test tags added to the FamilyTemplate Android app for
 ### Quick Actions
 - `hub_quick_action_{index}_button` - Quick action buttons (0: Add Chore, 1: View Calendar, 2: Add Reward, 3: View Gallery)
 
+### Empty State
+- `hub_empty_state` — Empty state view when no members exist
+
 ## ChoreBoardScreen Identifiers
 
 ### Navigation & Actions

package/templates/android/FamilyTemplate/app/build.gradle.kts

@@ -79,6 +79,11 @@ dependencies {
     // JSON Serialization
     implementation("com.google.code.gson:gson:2.10.1")
     
+    // Room
+    implementation(libs.room.runtime)
+    implementation(libs.room.ktx)
+    ksp(libs.room.compiler)
+    
     // Maps (for location sharing)
     implementation("com.google.maps.android:maps-compose:4.3.0")
     implementation("com.google.android.gms:play-services-maps:18.2.0")

package/templates/android/FamilyTemplate/app/src/main/java/com/appship/family/AppConfig.kt

@@ -35,4 +35,13 @@ object AppConfig {
         const val PRIVACY_POLICY_URL = "https://example.com/privacy"
         const val TERMS_URL = "https://example.com/terms"
     }
+    
+    // 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/FamilyTemplate/app/src/main/java/com/appship/family/FamilyApplication.kt

@@ -1,7 +1,16 @@
 package com.appship.family
 
 import android.app.Application
+import com.appship.family.data.local.LocalStorageProvider
 import dagger.hilt.android.HiltAndroidApp
 
 @HiltAndroidApp
-class FamilyApplication : Application()
+class FamilyApplication : Application() {
+    override fun onCreate() {
+        super.onCreate()
+        // Initialize Room-backed local storage (no-op if DataSource is .MOCK)
+        if (AppConfig.DataSource.active == AppConfig.DataSource.SourceType.LOCAL_STORAGE) {
+            LocalStorageProvider.initialize(this)
+        }
+    }
+}

package/templates/android/FamilyTemplate/app/src/main/java/com/appship/family/core/components/EmptyStateView.kt

@@ -0,0 +1,105 @@
+package com.appship.family.core.components
+
+import androidx.compose.foundation.layout.*
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.filled.*
+import androidx.compose.material3.*
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.graphics.vector.ImageVector
+import androidx.compose.ui.platform.testTag
+import androidx.compose.ui.text.style.TextAlign
+import androidx.compose.ui.unit.dp
+
+@Composable
+fun EmptyStateView(config: EmptyStateConfig, modifier: Modifier = Modifier) {
+    Column(
+        modifier = modifier
+            .fillMaxSize()
+            .padding(24.dp),
+        horizontalAlignment = Alignment.CenterHorizontally,
+        verticalArrangement = Arrangement.Center
+    ) {
+        config.icon?.let {
+            Icon(
+                it,
+                null,
+                Modifier
+                    .size(64.dp)
+                    .testTag("empty_state_icon"),
+                tint = config.iconColor ?: MaterialTheme.colorScheme.primary
+            )
+            Spacer(Modifier.height(16.dp))
+        }
+        Text(
+            config.title,
+            style = MaterialTheme.typography.titleLarge,
+            textAlign = TextAlign.Center,
+            modifier = Modifier.testTag("empty_state_title")
+        )
+        config.subtitle?.let {
+            Spacer(Modifier.height(8.dp))
+            Text(
+                it,
+                style = MaterialTheme.typography.bodyMedium,
+                color = MaterialTheme.colorScheme.onSurfaceVariant,
+                textAlign = TextAlign.Center,
+                modifier = Modifier.testTag("empty_state_subtitle")
+            )
+        }
+        if (config.buttonTitle != null && config.buttonAction != null) {
+            Spacer(Modifier.height(24.dp))
+            Button(
+                onClick = { config.buttonAction?.invoke() },
+                modifier = Modifier
+                    .fillMaxWidth()
+                    .testTag("empty_state_button")
+            ) {
+                Text(config.buttonTitle!!)
+            }
+        }
+    }
+}
+
+data class EmptyStateConfig(
+    val title: String,
+    val subtitle: String? = null,
+    val icon: ImageVector? = null,
+    val iconColor: Color? = null,
+    val buttonTitle: String? = null,
+    val buttonAction: (() -> Unit)? = null
+)
+
+object EmptyStatePresets {
+    fun noResults(searchQuery: String? = null) = EmptyStateConfig(
+        title = "No Results Found",
+        subtitle = searchQuery?.let { "We couldn't find anything matching \"$it\"" },
+        icon = Icons.Filled.Search
+    )
+
+    fun noItems(message: String? = null, onAdd: (() -> Unit)? = null) = EmptyStateConfig(
+        title = "Nothing Here Yet",
+        subtitle = message ?: "Get started by adding your first item",
+        icon = Icons.Filled.Inbox,
+        buttonTitle = if (onAdd != null) "Add Item" else null,
+        buttonAction = onAdd
+    )
+
+    fun noFavorites(onBrowse: (() -> Unit)? = null) = EmptyStateConfig(
+        title = "No Favorites Yet",
+        subtitle = "Items you favorite will appear here",
+        icon = Icons.Filled.FavoriteBorder,
+        buttonTitle = if (onBrowse != null) "Browse" else null,
+        buttonAction = onBrowse
+    )
+
+    fun noConnection(onRetry: () -> Unit) = EmptyStateConfig(
+        title = "No Internet Connection",
+        subtitle = "Please check your connection and try again",
+        icon = Icons.Filled.WifiOff,
+        buttonTitle = "Retry",
+        buttonAction = onRetry
+    )
+}

package/templates/android/FamilyTemplate/app/src/main/java/com/appship/family/data/DataRepository.kt

@@ -0,0 +1,65 @@
+package com.appship.family.data
+
+import kotlinx.coroutines.flow.StateFlow
+import java.util.Date
+
+/**
+ * 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 (only members is reactive via StateFlow)
+    val members: StateFlow<List<FamilyMember>>
+    
+    // Other properties are accessed synchronously (implementations may use StateFlow internally)
+    val chores: List<Chore>
+    val rewards: List<Reward>
+    val calendarEvents: List<CalendarEvent>
+    val milestones: List<Milestone>
+    val photos: List<Photo>
+    val locationUpdates: List<LocationUpdate>
+
+    // CRUD operations - Members
+    fun createMember(member: FamilyMember)
+    fun updateMember(member: FamilyMember)
+    fun deleteMember(member: FamilyMember)
+    fun memberById(id: String): FamilyMember?
+
+    // CRUD operations - Chores
+    fun createChore(chore: Chore)
+    fun updateChore(chore: Chore)
+    fun deleteChore(chore: Chore)
+    fun completeChore(chore: Chore, memberId: String)
+    fun choresForMember(memberId: String): List<Chore>
+    fun pendingChores(): List<Chore>
+
+    // CRUD operations - Rewards
+    fun createReward(reward: Reward)
+    fun updateReward(reward: Reward)
+    fun deleteReward(reward: Reward)
+    fun redeemReward(reward: Reward, memberId: String): Boolean
+    fun availableRewards(): List<Reward>
+
+    // CRUD operations - Calendar Events
+    fun createEvent(event: CalendarEvent)
+    fun updateEvent(event: CalendarEvent)
+    fun deleteEvent(event: CalendarEvent)
+    fun eventsForDate(date: Date): List<CalendarEvent>
+
+    // CRUD operations - Milestones
+    fun createMilestone(milestone: Milestone)
+    fun updateMilestone(milestone: Milestone)
+    fun deleteMilestone(milestone: Milestone)
+    fun milestonesForMember(memberId: String): List<Milestone>
+
+    // CRUD operations - Photos
+    fun createPhoto(photo: Photo)
+    fun updatePhoto(photo: Photo)
+    fun deletePhoto(photo: Photo)
+
+    // Reset
+    fun reset()
+}

package/templates/android/FamilyTemplate/app/src/main/java/com/appship/family/data/DataSourceResolver.kt

@@ -0,0 +1,21 @@
+package com.appship.family.data
+
+import com.appship.family.AppConfig
+import com.appship.family.data.local.LocalStorageProvider
+import com.appship.family.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 members by repository.members.collectAsState()
+ */
+object DataSourceResolver {
+    val repository: DataRepository
+        get() = when (AppConfig.DataSource.active) {
+            AppConfig.DataSource.SourceType.LOCAL_STORAGE -> LocalStorageProvider.getInstance()
+            AppConfig.DataSource.SourceType.MOCK -> MockDataProvider
+        }
+}

package/templates/android/FamilyTemplate/app/src/main/java/com/appship/family/data/local/AppDao.kt

@@ -0,0 +1,138 @@
+package com.appship.family.data.local
+
+import androidx.room.*
+
+/**
+ * Room DAO for FamilyMember, Chore, Reward, CalendarEvent, Milestone, Photo, and LocationUpdate CRUD operations.
+ */
+@Dao
+interface AppDao {
+
+    // — FamilyMembers —
+
+    @Query("SELECT * FROM family_members ORDER BY name ASC")
+    suspend fun getAllMembers(): List<FamilyMemberEntity>
+
+    @Query("SELECT * FROM family_members WHERE id = :id LIMIT 1")
+    suspend fun getMemberById(id: String): FamilyMemberEntity?
+
+    @Insert(onConflict = OnConflictStrategy.REPLACE)
+    suspend fun insertMember(member: FamilyMemberEntity)
+
+    @Update
+    suspend fun updateMember(member: FamilyMemberEntity)
+
+    @Delete
+    suspend fun deleteMember(member: FamilyMemberEntity)
+
+    // — Chores —
+
+    @Query("SELECT * FROM chores ORDER BY createdAtMillis DESC")
+    suspend fun getAllChores(): List<ChoreEntity>
+
+    @Query("SELECT * FROM chores WHERE id = :id LIMIT 1")
+    suspend fun getChoreById(id: String): ChoreEntity?
+
+    @Query("SELECT * FROM chores WHERE assignedTo = :memberId ORDER BY createdAtMillis DESC")
+    suspend fun getChoresByMember(memberId: String): List<ChoreEntity>
+
+    @Query("SELECT * FROM chores WHERE isCompleted = 0 ORDER BY createdAtMillis DESC")
+    suspend fun getPendingChores(): List<ChoreEntity>
+
+    @Insert(onConflict = OnConflictStrategy.REPLACE)
+    suspend fun insertChore(chore: ChoreEntity)
+
+    @Update
+    suspend fun updateChore(chore: ChoreEntity)
+
+    @Delete
+    suspend fun deleteChore(chore: ChoreEntity)
+
+    // — Rewards —
+
+    @Query("SELECT * FROM rewards ORDER BY createdAtMillis DESC")
+    suspend fun getAllRewards(): List<RewardEntity>
+
+    @Query("SELECT * FROM rewards WHERE id = :id LIMIT 1")
+    suspend fun getRewardById(id: String): RewardEntity?
+
+    @Query("SELECT * FROM rewards WHERE isRedeemed = 0 ORDER BY createdAtMillis DESC")
+    suspend fun getAvailableRewards(): List<RewardEntity>
+
+    @Insert(onConflict = OnConflictStrategy.REPLACE)
+    suspend fun insertReward(reward: RewardEntity)
+
+    @Update
+    suspend fun updateReward(reward: RewardEntity)
+
+    @Delete
+    suspend fun deleteReward(reward: RewardEntity)
+
+    // — CalendarEvents —
+
+    @Query("SELECT * FROM calendar_events ORDER BY dateMillis ASC")
+    suspend fun getAllEvents(): List<CalendarEventEntity>
+
+    @Query("SELECT * FROM calendar_events WHERE id = :id LIMIT 1")
+    suspend fun getEventById(id: String): CalendarEventEntity?
+
+    @Insert(onConflict = OnConflictStrategy.REPLACE)
+    suspend fun insertEvent(event: CalendarEventEntity)
+
+    @Update
+    suspend fun updateEvent(event: CalendarEventEntity)
+
+    @Delete
+    suspend fun deleteEvent(event: CalendarEventEntity)
+
+    // — Milestones —
+
+    @Query("SELECT * FROM milestones ORDER BY dateMillis DESC")
+    suspend fun getAllMilestones(): List<MilestoneEntity>
+
+    @Query("SELECT * FROM milestones WHERE id = :id LIMIT 1")
+    suspend fun getMilestoneById(id: String): MilestoneEntity?
+
+    @Query("SELECT * FROM milestones WHERE memberId = :memberId ORDER BY dateMillis DESC")
+    suspend fun getMilestonesByMember(memberId: String): List<MilestoneEntity>
+
+    @Insert(onConflict = OnConflictStrategy.REPLACE)
+    suspend fun insertMilestone(milestone: MilestoneEntity)
+
+    @Update
+    suspend fun updateMilestone(milestone: MilestoneEntity)
+
+    @Delete
+    suspend fun deleteMilestone(milestone: MilestoneEntity)
+
+    // — Photos —
+
+    @Query("SELECT * FROM photos ORDER BY uploadedAtMillis DESC")
+    suspend fun getAllPhotos(): List<PhotoEntity>
+
+    @Query("SELECT * FROM photos WHERE id = :id LIMIT 1")
+    suspend fun getPhotoById(id: String): PhotoEntity?
+
+    @Insert(onConflict = OnConflictStrategy.REPLACE)
+    suspend fun insertPhoto(photo: PhotoEntity)
+
+    @Update
+    suspend fun updatePhoto(photo: PhotoEntity)
+
+    @Delete
+    suspend fun deletePhoto(photo: PhotoEntity)
+
+    // — LocationUpdates —
+
+    @Query("SELECT * FROM location_updates ORDER BY timestampMillis DESC")
+    suspend fun getAllLocationUpdates(): List<LocationUpdateEntity>
+
+    @Query("SELECT * FROM location_updates WHERE id = :id LIMIT 1")
+    suspend fun getLocationUpdateById(id: String): LocationUpdateEntity?
+
+    @Insert(onConflict = OnConflictStrategy.REPLACE)
+    suspend fun insertLocationUpdate(location: LocationUpdateEntity)
+
+    @Delete
+    suspend fun deleteLocationUpdate(location: LocationUpdateEntity)
+}

package/templates/android/FamilyTemplate/app/src/main/java/com/appship/family/data/local/AppDatabase.kt

@@ -0,0 +1,42 @@
+package com.appship.family.data.local
+
+import android.content.Context
+import androidx.room.Database
+import androidx.room.Room
+import androidx.room.RoomDatabase
+
+/**
+ * Room database for local storage.
+ * Holds FamilyMemberEntity, ChoreEntity, RewardEntity, CalendarEventEntity, MilestoneEntity, PhotoEntity, and LocationUpdateEntity tables.
+ */
+@Database(
+    entities = [
+        FamilyMemberEntity::class,
+        ChoreEntity::class,
+        RewardEntity::class,
+        CalendarEventEntity::class,
+        MilestoneEntity::class,
+        PhotoEntity::class,
+        LocationUpdateEntity::class
+    ],
+    version = 1,
+    exportSchema = false
+)
+abstract class AppDatabase : RoomDatabase() {
+    abstract fun appDao(): AppDao
+
+    companion object {
+        @Volatile
+        private var INSTANCE: AppDatabase? = null
+
+        fun getInstance(context: Context): AppDatabase {
+            return INSTANCE ?: synchronized(this) {
+                INSTANCE ?: Room.databaseBuilder(
+                    context.applicationContext,
+                    AppDatabase::class.java,
+                    "family_database"
+                ).build().also { INSTANCE = it }
+            }
+        }
+    }
+}

package/templates/android/FamilyTemplate/app/src/main/java/com/appship/family/data/local/CalendarEventEntity.kt

@@ -0,0 +1,55 @@
+package com.appship.family.data.local
+
+import androidx.room.Entity
+import androidx.room.PrimaryKey
+import com.appship.family.data.CalendarEvent
+import com.appship.family.data.CalendarEventType
+import com.google.gson.Gson
+import java.util.Date
+
+/**
+ * Room entity for CalendarEvent persistence.
+ */
+@Entity(tableName = "calendar_events")
+data class CalendarEventEntity(
+    @PrimaryKey val id: String,
+    val title: String = "",
+    val dateMillis: Long = System.currentTimeMillis(),
+    val membersJson: String = "[]",
+    val type: String = "FAMILY",
+    val description: String? = null,
+    val location: String? = null,
+    val createdAtMillis: Long = System.currentTimeMillis()
+) {
+    fun toCalendarEvent(): CalendarEvent = CalendarEvent(
+        id = id,
+        title = title,
+        date = Date(dateMillis),
+        members = parseJsonArray(membersJson),
+        type = CalendarEventType.valueOf(type),
+        description = description,
+        location = location,
+        createdAt = Date(createdAtMillis)
+    )
+
+    private fun parseJsonArray(json: String): List<String> {
+        return try {
+            Gson().fromJson(json, Array<String>::class.java)?.toList() ?: emptyList()
+        } catch (_: Exception) {
+            emptyList()
+        }
+    }
+
+    companion object {
+        fun fromCalendarEvent(event: CalendarEvent): CalendarEventEntity = CalendarEventEntity(
+            id = event.id,
+            title = event.title,
+            dateMillis = event.date.time,
+            membersJson = Gson().toJson(event.members),
+            type = event.type.name,
+            description = event.description,
+            location = event.location,
+            createdAtMillis = event.createdAt.time
+        )
+    }
+}

package/templates/android/FamilyTemplate/app/src/main/java/com/appship/family/data/local/ChoreEntity.kt

@@ -0,0 +1,58 @@
+package com.appship.family.data.local
+
+import androidx.room.Entity
+import androidx.room.PrimaryKey
+import com.appship.family.data.Chore
+import com.appship.family.data.ChoreFrequency
+import java.util.Date
+
+/**
+ * Room entity for Chore persistence.
+ */
+@Entity(tableName = "chores")
+data class ChoreEntity(
+    @PrimaryKey val id: String,
+    val title: String = "",
+    val description: String? = null,
+    val assignedTo: String? = null,
+    val points: Int = 0,
+    val frequency: String = "",
+    val isCompleted: Boolean = false,
+    val dueDateMillis: Long? = null,
+    val completedAtMillis: Long? = null,
+    val completedBy: String? = null,
+    val createdAtMillis: Long = System.currentTimeMillis(),
+    val requiresApproval: Boolean = false
+) {
+    fun toChore(): Chore = Chore(
+        id = id,
+        title = title,
+        description = description,
+        assignedTo = assignedTo,
+        points = points,
+        frequency = ChoreFrequency.values().find { it.name == frequency } ?: ChoreFrequency.ONE_TIME,
+        isCompleted = isCompleted,
+        dueDate = dueDateMillis?.let { Date(it) },
+        completedAt = completedAtMillis?.let { Date(it) },
+        completedBy = completedBy,
+        createdAt = Date(createdAtMillis),
+        requiresApproval = requiresApproval
+    )
+
+    companion object {
+        fun fromChore(chore: Chore): ChoreEntity = ChoreEntity(
+            id = chore.id,
+            title = chore.title,
+            description = chore.description,
+            assignedTo = chore.assignedTo,
+            points = chore.points,
+            frequency = chore.frequency.name,
+            isCompleted = chore.isCompleted,
+            dueDateMillis = chore.dueDate?.time,
+            completedAtMillis = chore.completedAt?.time,
+            completedBy = chore.completedBy,
+            createdAtMillis = chore.createdAt.time,
+            requiresApproval = chore.requiresApproval
+        )
+    }
+}

package/templates/android/FamilyTemplate/app/src/main/java/com/appship/family/data/local/FamilyMemberEntity.kt

@@ -0,0 +1,52 @@
+package com.appship.family.data.local
+
+import androidx.room.Entity
+import androidx.room.PrimaryKey
+import com.appship.family.data.FamilyMember
+import com.appship.family.data.MemberRole
+import com.google.gson.Gson
+import java.util.Date
+
+/**
+ * Room entity for FamilyMember persistence.
+ */
+@Entity(tableName = "family_members")
+data class FamilyMemberEntity(
+    @PrimaryKey val id: String,
+    val name: String = "",
+    val avatarURL: String? = null,
+    val role: String = "",
+    val points: Int = 0,
+    val choresJson: String = "[]",
+    val createdAtMillis: Long = System.currentTimeMillis()
+) {
+    fun toFamilyMember(): FamilyMember = FamilyMember(
+        id = id,
+        name = name,
+        avatarURL = avatarURL,
+        role = MemberRole.values().find { it.name == role } ?: MemberRole.CHILD,
+        points = points,
+        chores = parseJsonArray(choresJson),
+        createdAt = Date(createdAtMillis)
+    )
+
+    private fun parseJsonArray(json: String): List<String> {
+        return try {
+            Gson().fromJson(json, Array<String>::class.java)?.toList() ?: emptyList()
+        } catch (_: Exception) {
+            emptyList()
+        }
+    }
+
+    companion object {
+        fun fromFamilyMember(member: FamilyMember): FamilyMemberEntity = FamilyMemberEntity(
+            id = member.id,
+            name = member.name,
+            avatarURL = member.avatarURL,
+            role = member.role.name,
+            points = member.points,
+            choresJson = Gson().toJson(member.chores),
+            createdAtMillis = member.createdAt.time
+        )
+    }
+}