@shaykec/app-agent 1.0.8 → 1.0.10

package/templates/android/ReferenceTemplate/app/src/main/kotlin/com/appship/reference/core/animation/AnimatedTransitionsModifiers.kt

@@ -1,14 +1,24 @@
 package com.appship.reference.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/ReferenceTemplate/app/src/main/kotlin/com/appship/reference/features/settings/SettingsScreen.kt

@@ -1,4 +1,4 @@
-package com.appship.reference.features
+package com.appship.reference.features.settings
 
 import androidx.compose.foundation.clickable
 import androidx.compose.foundation.layout.*

package/templates/android/ShopTemplate/app/src/main/kotlin/com/appship/shop/core/animation/AnimatedTransitionsModifiers.kt

@@ -1,14 +1,24 @@
 package com.appship.shop.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/ShopTemplate/app/src/main/kotlin/com/appship/shop/features/cart/CartScreen.kt

@@ -294,9 +294,10 @@ fun OrderSummaryCard(
     discountCode: String?,
     shipping: Double,
     tax: Double,
-    total: Double
+    total: Double,
+    modifier: Modifier = Modifier
 ) {
-    Card {
+    Card(modifier = modifier) {
         Column(modifier = Modifier.padding(16.dp)) {
             Text(
                 "Order Summary",

package/templates/android/Skeleton/TESTING_MANIFEST.md

@@ -48,7 +48,8 @@ This document catalogs all test tags in the Skeleton template for automated test
 - `profile_name` — User name
 - `profile_email` — User email
 - `profile_notifications` — Notifications setting
-- `profile_appearance` — Appearance setting
+- `profile_appearance` — Appearance / Dark Mode row
+- `profile_dark_mode_toggle` — Dark mode toggle switch
 - `profile_motion_preferences` — Motion Preferences / Animations link
 - `profile_version` — App version
 - `profile_privacy` — Privacy policy

package/templates/android/Skeleton/app/src/main/kotlin/com/appship/skeleton/MainActivity.kt

@@ -4,18 +4,39 @@ import android.os.Bundle
 import androidx.activity.ComponentActivity
 import androidx.activity.compose.setContent
 import androidx.activity.enableEdgeToEdge
+import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.runtime.CompositionLocalProvider
+import androidx.compose.runtime.remember
+import androidx.compose.ui.ExperimentalComposeUiApi
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.semantics.semantics
+import androidx.compose.ui.semantics.testTagsAsResourceId
+import com.appship.skeleton.core.theme.AppearanceManager
+import com.appship.skeleton.core.theme.LocalAppearanceManager
 import com.appship.skeleton.core.theme.SkeletonTheme
+import com.appship.skeleton.core.theme.resolveIsDarkTheme
 import com.appship.skeleton.features.navigation.MainScreen
 import dagger.hilt.android.AndroidEntryPoint
 
 @AndroidEntryPoint
 class MainActivity : ComponentActivity() {
+    @OptIn(ExperimentalComposeUiApi::class)
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         enableEdgeToEdge()
         setContent {
-            SkeletonTheme {
-                MainScreen()
+            val appearanceManager = remember { AppearanceManager(this) }
+            CompositionLocalProvider(LocalAppearanceManager provides appearanceManager) {
+                SkeletonTheme(darkTheme = resolveIsDarkTheme(appearanceManager)) {
+                    Box(
+                        modifier = Modifier
+                            .fillMaxSize()
+                            .semantics { testTagsAsResourceId = true }
+                    ) {
+                        MainScreen()
+                    }
+                }
             }
         }
     }

package/templates/android/Skeleton/app/src/main/kotlin/com/appship/skeleton/core/animation/AnimatedTransitionsModifiers.kt

@@ -1,14 +1,24 @@
 package com.appship.skeleton.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)
+}