@shaykec/app-agent 1.0.8 → 1.0.10

package/templates/android/Skeleton/app/src/main/kotlin/com/appship/skeleton/core/theme/AppearanceManager.kt

@@ -0,0 +1,42 @@
+package com.appship.skeleton.core.theme
+
+import android.content.Context
+import android.content.SharedPreferences
+import androidx.compose.foundation.isSystemInDarkTheme
+import androidx.compose.runtime.*
+import androidx.compose.runtime.staticCompositionLocalOf
+
+// CUSTOMIZE:APPEARANCE - Dark mode and appearance management
+enum class AppearanceMode { SYSTEM, LIGHT, DARK }
+
+class AppearanceManager(context: Context) {
+    private val prefs: SharedPreferences =
+        context.getSharedPreferences("appearance_prefs", Context.MODE_PRIVATE)
+
+    var appearanceMode: AppearanceMode by mutableStateOf(
+        try {
+            AppearanceMode.valueOf(prefs.getString("appearance_mode", "SYSTEM") ?: "SYSTEM")
+        } catch (_: Exception) {
+            AppearanceMode.SYSTEM
+        }
+    )
+        private set
+
+    fun setMode(mode: AppearanceMode) {
+        appearanceMode = mode
+        prefs.edit().putString("appearance_mode", mode.name).apply()
+    }
+}
+
+val LocalAppearanceManager = staticCompositionLocalOf<AppearanceManager> {
+    error("No AppearanceManager provided")
+}
+
+@Composable
+fun resolveIsDarkTheme(appearanceManager: AppearanceManager): Boolean {
+    return when (appearanceManager.appearanceMode) {
+        AppearanceMode.SYSTEM -> isSystemInDarkTheme()
+        AppearanceMode.LIGHT -> false
+        AppearanceMode.DARK -> true
+    }
+}

package/templates/android/Skeleton/app/src/main/kotlin/com/appship/skeleton/features/profile/ProfileScreen.kt

@@ -17,6 +17,8 @@ import androidx.compose.ui.res.stringResource
 import androidx.compose.ui.unit.dp
 import com.appship.skeleton.AppConfig
 import com.appship.skeleton.R
+import com.appship.skeleton.core.theme.AppearanceMode
+import com.appship.skeleton.core.theme.LocalAppearanceManager
 
 // PLACEHOLDER: Customize this screen for user profile and settings.
 
@@ -94,14 +96,24 @@ fun ProfileScreen(
                             .testTag("profile_notifications")
                     )
                     HorizontalDivider()
-                    ListItem(
-                        headlineContent = { Text("Appearance") },
-                        leadingContent = { Icon(Icons.Default.Palette, contentDescription = null) },
-                        trailingContent = { Icon(Icons.Default.ChevronRight, contentDescription = null) },
-                        modifier = Modifier
-                            .clickable { /* Navigate to appearance */ }
-                            .testTag("profile_appearance")
-                    )
+                    run {
+                        val appearanceManager = LocalAppearanceManager.current
+                        val isDark = appearanceManager.appearanceMode == AppearanceMode.DARK
+                        ListItem(
+                            headlineContent = { Text("Dark Mode") },
+                            leadingContent = { Icon(Icons.Default.DarkMode, contentDescription = null) },
+                            trailingContent = {
+                                Switch(
+                                    checked = isDark,
+                                    onCheckedChange = { checked ->
+                                        appearanceManager.setMode(if (checked) AppearanceMode.DARK else AppearanceMode.SYSTEM)
+                                    },
+                                    modifier = Modifier.testTag("profile_dark_mode_toggle")
+                                )
+                            },
+                            modifier = Modifier.testTag("profile_appearance")
+                        )
+                    }
                     if (AppConfig.Features.ENABLE_ANIMATIONS) {
                         HorizontalDivider()
                         ListItem(

package/templates/android/Skeleton/tests/03_detail_screen.yaml

@@ -7,8 +7,9 @@ appId: ${APP_PACKAGE_NAME}
     timeout: 3000
 - assertVisible: "Home"
 - extendedWaitUntil:
-    visible: "home_item_0_card"
-    timeout: 2000
+    visible:
+        id: "home_item_0_card"
+    timeout: 5000
 - tapOn:
     id: "home_item_0_card"
 - assertVisible:

package/templates/android/Skeleton/tests/04_favorites.yaml

@@ -7,8 +7,9 @@ appId: ${APP_PACKAGE_NAME}
     timeout: 3000
 - assertVisible: "Home"
 - extendedWaitUntil:
-    visible: "home_item_0_card"
-    timeout: 2000
+    visible:
+        id: "home_item_0_card"
+    timeout: 5000
 # Favorite an item first
 - tapOn:
     id: "home_item_0_card"

package/templates/android/Skeleton/tests/08_full_e2e.yaml

@@ -8,8 +8,9 @@ appId: ${APP_PACKAGE_NAME}
 # Home tab
 - assertVisible: "Home"
 - extendedWaitUntil:
-    visible: "home_item_0_card"
-    timeout: 2000
+    visible:
+        id: "home_item_0_card"
+    timeout: 5000
 # Detail from home
 - tapOn:
     id: "home_item_0_card"
@@ -44,6 +45,12 @@ appId: ${APP_PACKAGE_NAME}
 - assertVisible:
     id: "motion_prefs_full_button"
     optional: true
+- assertVisible:
+    id: "motion_prefs_reduced_button"
+    optional: true
+- assertVisible:
+    id: "motion_prefs_off_button"
+    optional: true
 - tapOn:
     id: "motion_prefs_reduced_button"
 - back

package/templates/android/Skeleton/tests/09_dark_mode.yaml

@@ -0,0 +1,50 @@
+appId: ${APP_PACKAGE_NAME}
+---
+- clearState
+- launchApp
+- extendedWaitUntil:
+    visible: "Home"
+    timeout: 3000
+# Navigate to Profile
+- tapOn: "Profile"
+- extendedWaitUntil:
+    visible:
+        id: "profile_avatar"
+    timeout: 3000
+# Verify dark mode toggle is visible
+- assertVisible:
+    id: "profile_dark_mode_toggle"
+# Toggle dark mode ON
+- tapOn:
+    id: "profile_dark_mode_toggle"
+# Verify profile still renders in dark mode
+- assertVisible:
+    id: "profile_avatar"
+    optional: true
+- assertVisible:
+    id: "profile_name"
+    optional: true
+# Navigate to Home to verify dark mode persists across tabs
+- tapOn: "Home"
+- extendedWaitUntil:
+    visible: "Home"
+    timeout: 3000
+# Navigate back to Profile
+- tapOn: "Profile"
+- extendedWaitUntil:
+    visible:
+        id: "profile_avatar"
+    timeout: 3000
+# Verify toggle is still ON (dark mode persisted)
+- assertVisible:
+    id: "profile_dark_mode_toggle"
+# Toggle dark mode OFF (back to system)
+- tapOn:
+    id: "profile_dark_mode_toggle"
+# Verify profile renders normally
+- assertVisible:
+    id: "profile_avatar"
+    optional: true
+- assertVisible:
+    id: "profile_name"
+    optional: true

package/templates/android/SocialTemplate/app/src/main/kotlin/com/appship/social/core/animation/AnimatedTransitionsModifiers.kt

@@ -1,14 +1,24 @@
 package com.appship.social.core.animation
 
+import android.view.HapticFeedbackConstants
 import androidx.compose.animation.*
 import androidx.compose.animation.core.*
+import androidx.compose.foundation.clickable
+import androidx.compose.foundation.gestures.detectTapGestures
+import androidx.compose.foundation.interaction.MutableInteractionSource
+import androidx.compose.foundation.interaction.collectIsPressedAsState
 import androidx.compose.foundation.layout.offset
 import androidx.compose.runtime.*
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.composed
 import androidx.compose.ui.draw.alpha
 import androidx.compose.ui.draw.scale
+import androidx.compose.ui.draw.shadow
+import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.input.pointer.pointerInput
+import androidx.compose.ui.platform.LocalView
 import androidx.compose.ui.unit.IntOffset
+import androidx.compose.ui.unit.dp
 
 /**
  * Staggered appear animation for list items.
@@ -118,3 +128,181 @@ fun Modifier.bounceOnChange(
 
     this.scale(bounceAnim)
 }
+
+/**
+ * Scale-down press feedback for tappable elements.
+ * Scales to 0.95 on press with spring return animation.
+ */
+fun Modifier.scaleOnPress(): Modifier = composed {
+    val interactionSource = remember { MutableInteractionSource() }
+    val isPressed by interactionSource.collectIsPressedAsState()
+
+    val scale by animateFloatAsState(
+        targetValue = if (isPressed) 0.95f else 1f,
+        animationSpec = spring(
+            dampingRatio = Spring.DampingRatioMediumBouncy,
+            stiffness = Spring.StiffnessMedium
+        ),
+        label = "pressScale"
+    )
+
+    this
+        .scale(scale)
+        .clickable(
+            interactionSource = interactionSource,
+            indication = null
+        ) { }
+}
+
+/**
+ * Triggers haptic feedback on tap.
+ */
+fun Modifier.hapticFeedback(): Modifier = composed {
+    val view = LocalView.current
+    this.pointerInput(Unit) {
+        detectTapGestures {
+            view.performHapticFeedback(HapticFeedbackConstants.KEYBOARD_TAP)
+        }
+    }
+}
+
+/**
+ * Slide-from-side + fade-in animation on appear.
+ */
+fun Modifier.slideAndFade(
+    delayMs: Int = 0,
+    durationMs: Int = 400
+): Modifier = composed {
+    var isVisible by remember { mutableStateOf(false) }
+
+    val alpha by animateFloatAsState(
+        targetValue = if (isVisible) 1f else 0f,
+        animationSpec = tween(
+            durationMillis = durationMs,
+            delayMillis = delayMs,
+            easing = FastOutSlowInEasing
+        ),
+        label = "slideAndFadeAlpha"
+    )
+
+    val offsetX by animateIntAsState(
+        targetValue = if (isVisible) 0 else 40,
+        animationSpec = tween(
+            durationMillis = durationMs,
+            delayMillis = delayMs,
+            easing = FastOutSlowInEasing
+        ),
+        label = "slideAndFadeOffsetX"
+    )
+
+    LaunchedEffect(Unit) {
+        isVisible = true
+    }
+
+    this
+        .alpha(alpha)
+        .offset { IntOffset(offsetX, 0) }
+}
+
+/**
+ * Subtle colored shadow for cards and elevated surfaces.
+ * Uses Material 3 elevation with optional color tinting.
+ */
+fun Modifier.cardShadow(
+    color: Color = Color.Black,
+    elevation: Float = 4f
+): Modifier = composed {
+    this.shadow(
+        elevation = elevation.dp,
+        ambientColor = color.copy(alpha = 0.08f),
+        spotColor = color.copy(alpha = 0.12f),
+        shape = androidx.compose.foundation.shape.RoundedCornerShape(12.dp)
+    )
+}
+
+/**
+ * Deeper shadow for floating elements (FABs, modals).
+ */
+fun Modifier.elevatedShadow(
+    color: Color = Color.Black
+): Modifier = composed {
+    this.shadow(
+        elevation = 8.dp,
+        ambientColor = color.copy(alpha = 0.12f),
+        spotColor = color.copy(alpha = 0.16f),
+        shape = androidx.compose.foundation.shape.RoundedCornerShape(16.dp)
+    )
+}
+
+/**
+ * Shimmer loading overlay for skeleton placeholder views.
+ * Sweeps a translucent gradient across the content repeatedly.
+ */
+fun Modifier.shimmer(
+    durationMs: Int = 1500
+): Modifier = composed {
+    val transition = rememberInfiniteTransition(label = "shimmer")
+    val translateAnim by transition.animateFloat(
+        initialValue = -1f,
+        targetValue = 2f,
+        animationSpec = infiniteRepeatable(
+            animation = tween(durationMillis = durationMs, easing = LinearEasing),
+            repeatMode = RepeatMode.Restart
+        ),
+        label = "shimmerTranslate"
+    )
+
+    this.alpha(0.3f + 0.7f * ((translateAnim + 1f) / 3f).coerceIn(0f, 1f))
+}
+
+/**
+ * Repeating scale pulse animation for live indicators and notifications.
+ */
+fun Modifier.pulse(
+    intensity: Float = 0.05f,
+    durationMs: Int = 1000
+): Modifier = composed {
+    val transition = rememberInfiniteTransition(label = "pulse")
+    val scale by transition.animateFloat(
+        initialValue = 1f,
+        targetValue = 1f + intensity,
+        animationSpec = infiniteRepeatable(
+            animation = tween(durationMillis = durationMs, easing = FastOutSlowInEasing),
+            repeatMode = RepeatMode.Reverse
+        ),
+        label = "pulseScale"
+    )
+
+    this.scale(scale)
+}
+
+/**
+ * Heart/like bounce effect when toggled active.
+ * Scales up to 1.3x then springs back. Perfect for favorite buttons.
+ */
+fun Modifier.heartBounce(
+    isActive: Boolean
+): Modifier = composed {
+    var previousActive by remember { mutableStateOf(isActive) }
+    var animatedScale by remember { mutableFloatStateOf(1f) }
+
+    val bounceAnim by animateFloatAsState(
+        targetValue = animatedScale,
+        animationSpec = spring(
+            dampingRatio = Spring.DampingRatioMediumBouncy,
+            stiffness = Spring.StiffnessMedium
+        ),
+        label = "heartBounce"
+    )
+
+    LaunchedEffect(isActive) {
+        if (isActive && !previousActive) {
+            animatedScale = 1.3f
+            kotlinx.coroutines.delay(200)
+            animatedScale = 1f
+        }
+        previousActive = isActive
+    }
+
+    this.scale(bounceAnim)
+}

package/templates/android/TaskTemplate/app/src/main/kotlin/com/appship/task/core/animation/AnimatedTransitionsModifiers.kt

@@ -1,14 +1,24 @@
 package com.appship.task.core.animation
 
+import android.view.HapticFeedbackConstants
 import androidx.compose.animation.*
 import androidx.compose.animation.core.*
+import androidx.compose.foundation.clickable
+import androidx.compose.foundation.gestures.detectTapGestures
+import androidx.compose.foundation.interaction.MutableInteractionSource
+import androidx.compose.foundation.interaction.collectIsPressedAsState
 import androidx.compose.foundation.layout.offset
 import androidx.compose.runtime.*
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.composed
 import androidx.compose.ui.draw.alpha
 import androidx.compose.ui.draw.scale
+import androidx.compose.ui.draw.shadow
+import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.input.pointer.pointerInput
+import androidx.compose.ui.platform.LocalView
 import androidx.compose.ui.unit.IntOffset
+import androidx.compose.ui.unit.dp
 
 /**
  * Staggered appear animation for list items.
@@ -118,3 +128,181 @@ fun Modifier.bounceOnChange(
 
     this.scale(bounceAnim)
 }
+
+/**
+ * Scale-down press feedback for tappable elements.
+ * Scales to 0.95 on press with spring return animation.
+ */
+fun Modifier.scaleOnPress(): Modifier = composed {
+    val interactionSource = remember { MutableInteractionSource() }
+    val isPressed by interactionSource.collectIsPressedAsState()
+
+    val scale by animateFloatAsState(
+        targetValue = if (isPressed) 0.95f else 1f,
+        animationSpec = spring(
+            dampingRatio = Spring.DampingRatioMediumBouncy,
+            stiffness = Spring.StiffnessMedium
+        ),
+        label = "pressScale"
+    )
+
+    this
+        .scale(scale)
+        .clickable(
+            interactionSource = interactionSource,
+            indication = null
+        ) { }
+}
+
+/**
+ * Triggers haptic feedback on tap.
+ */
+fun Modifier.hapticFeedback(): Modifier = composed {
+    val view = LocalView.current
+    this.pointerInput(Unit) {
+        detectTapGestures {
+            view.performHapticFeedback(HapticFeedbackConstants.KEYBOARD_TAP)
+        }
+    }
+}
+
+/**
+ * Slide-from-side + fade-in animation on appear.
+ */
+fun Modifier.slideAndFade(
+    delayMs: Int = 0,
+    durationMs: Int = 400
+): Modifier = composed {
+    var isVisible by remember { mutableStateOf(false) }
+
+    val alpha by animateFloatAsState(
+        targetValue = if (isVisible) 1f else 0f,
+        animationSpec = tween(
+            durationMillis = durationMs,
+            delayMillis = delayMs,
+            easing = FastOutSlowInEasing
+        ),
+        label = "slideAndFadeAlpha"
+    )
+
+    val offsetX by animateIntAsState(
+        targetValue = if (isVisible) 0 else 40,
+        animationSpec = tween(
+            durationMillis = durationMs,
+            delayMillis = delayMs,
+            easing = FastOutSlowInEasing
+        ),
+        label = "slideAndFadeOffsetX"
+    )
+
+    LaunchedEffect(Unit) {
+        isVisible = true
+    }
+
+    this
+        .alpha(alpha)
+        .offset { IntOffset(offsetX, 0) }
+}
+
+/**
+ * Subtle colored shadow for cards and elevated surfaces.
+ * Uses Material 3 elevation with optional color tinting.
+ */
+fun Modifier.cardShadow(
+    color: Color = Color.Black,
+    elevation: Float = 4f
+): Modifier = composed {
+    this.shadow(
+        elevation = elevation.dp,
+        ambientColor = color.copy(alpha = 0.08f),
+        spotColor = color.copy(alpha = 0.12f),
+        shape = androidx.compose.foundation.shape.RoundedCornerShape(12.dp)
+    )
+}
+
+/**
+ * Deeper shadow for floating elements (FABs, modals).
+ */
+fun Modifier.elevatedShadow(
+    color: Color = Color.Black
+): Modifier = composed {
+    this.shadow(
+        elevation = 8.dp,
+        ambientColor = color.copy(alpha = 0.12f),
+        spotColor = color.copy(alpha = 0.16f),
+        shape = androidx.compose.foundation.shape.RoundedCornerShape(16.dp)
+    )
+}
+
+/**
+ * Shimmer loading overlay for skeleton placeholder views.
+ * Sweeps a translucent gradient across the content repeatedly.
+ */
+fun Modifier.shimmer(
+    durationMs: Int = 1500
+): Modifier = composed {
+    val transition = rememberInfiniteTransition(label = "shimmer")
+    val translateAnim by transition.animateFloat(
+        initialValue = -1f,
+        targetValue = 2f,
+        animationSpec = infiniteRepeatable(
+            animation = tween(durationMillis = durationMs, easing = LinearEasing),
+            repeatMode = RepeatMode.Restart
+        ),
+        label = "shimmerTranslate"
+    )
+
+    this.alpha(0.3f + 0.7f * ((translateAnim + 1f) / 3f).coerceIn(0f, 1f))
+}
+
+/**
+ * Repeating scale pulse animation for live indicators and notifications.
+ */
+fun Modifier.pulse(
+    intensity: Float = 0.05f,
+    durationMs: Int = 1000
+): Modifier = composed {
+    val transition = rememberInfiniteTransition(label = "pulse")
+    val scale by transition.animateFloat(
+        initialValue = 1f,
+        targetValue = 1f + intensity,
+        animationSpec = infiniteRepeatable(
+            animation = tween(durationMillis = durationMs, easing = FastOutSlowInEasing),
+            repeatMode = RepeatMode.Reverse
+        ),
+        label = "pulseScale"
+    )
+
+    this.scale(scale)
+}
+
+/**
+ * Heart/like bounce effect when toggled active.
+ * Scales up to 1.3x then springs back. Perfect for favorite buttons.
+ */
+fun Modifier.heartBounce(
+    isActive: Boolean
+): Modifier = composed {
+    var previousActive by remember { mutableStateOf(isActive) }
+    var animatedScale by remember { mutableFloatStateOf(1f) }
+
+    val bounceAnim by animateFloatAsState(
+        targetValue = animatedScale,
+        animationSpec = spring(
+            dampingRatio = Spring.DampingRatioMediumBouncy,
+            stiffness = Spring.StiffnessMedium
+        ),
+        label = "heartBounce"
+    )
+
+    LaunchedEffect(isActive) {
+        if (isActive && !previousActive) {
+            animatedScale = 1.3f
+            kotlinx.coroutines.delay(200)
+            animatedScale = 1f
+        }
+        previousActive = isActive
+    }
+
+    this.scale(bounceAnim)
+}

package/templates/android/TaskTemplate/app/src/main/kotlin/com/appship/task/features/settings/SettingsScreen.kt

@@ -6,6 +6,7 @@ import androidx.compose.material3.*
 import androidx.compose.runtime.*
 import androidx.compose.ui.Modifier
 import androidx.compose.foundation.clickable
+import androidx.compose.material.icons.Icons
 import androidx.compose.material.icons.filled.*
 import androidx.compose.ui.platform.testTag
 import androidx.compose.ui.res.stringResource
@@ -69,8 +70,8 @@ fun SettingsScreen(
                 item {
                     ListItem(
                         headlineContent = { Text(stringResource(R.string.motion_prefs_animation_level)) },
-                        leadingContent = { Icon(Icons.Default.AutoAwesome, contentDescription = null) },
-                        trailingContent = { Icon(Icons.Default.ChevronRight, contentDescription = null) },
+                        leadingContent = { Icon(Icons.Default.Star, contentDescription = null) },
+                        trailingContent = { Icon(Icons.Default.ArrowForward, contentDescription = null) },
                         modifier = Modifier
                             .clickable { onMotionPreferencesClick() }
                             .testTag("profile_motion_preferences")