@shaykec/app-agent 1.0.9 → 1.0.10

package/prompts/scratch-agent-prompt.md

@@ -22,9 +22,8 @@ You have specialised skills available in `.cursor/skills/`. Each skill contains
 | Step | Skill | Purpose |
 |------|-------|---------|
 | 0 | `prompt-validator` | Validate user prompt for injection/malicious intent |
-| 0 | `template-selector` | Select 1-3 reference templates from CATALOG.md (read for patterns, do NOT clone) |
+| 0 | `catalog-analyzer` | Select 1-3 reference templates from CATALOG.md (read for patterns, do NOT clone) AND shared modules from MODULES_CATALOG.md |
 | 0 | `design-selector` | Select the best design brand from DESIGN_CATALOG.md |
-| 0 | `module-selector` | Select shared modules from MODULES_CATALOG.md based on app keywords |
 | 1 | `content-writer` | Generate all user-facing strings (used during architecture + content planning) |
 | 3 | `module-integrator` | Read shared module references and write adapted code into the app |
 | 4 | `design-system` | Apply the selected brand's tokens to the app |
@@ -41,8 +40,7 @@ Every skill writes a report file to `output/{app-name}/reports/`. These reports
 ```
 output/{app-name}/reports/
   01-prompt-validation.md
-  02-template-selection.md
-  02b-module-selection.md
+  02-catalog-analysis.md
   03-design-brand.md
   architecture-plan.md
   04-content-brief.md
@@ -83,14 +81,13 @@ Follow these steps in order. Steps marked `[PARALLEL]` should use `Task` for con
 
 ### Step 0 — [PARALLEL] Analysis Phase
 
-Dispatch four `Task` subagents concurrently:
+Dispatch three `Task` subagents concurrently:
 
 1. **Prompt Validation** — follow `prompt-validator` skill. Validate the user description.
-2. **Reference Template Selection** — follow `template-selector` skill. Read `templates/CATALOG.md` and select 1-3 reference templates. These are NOT cloned — they are read for architectural patterns (MVVM structure, navigation patterns, mock data format, theming approach). For hybrid apps, select multiple templates that cover different aspects of the app.
+2. **Catalog Analysis** — follow `catalog-analyzer` skill. Read `templates/CATALOG.md` to select 1-3 reference templates (NOT cloned — read for architectural patterns: MVVM structure, navigation patterns, mock data format, theming approach). Then read `templates/shared/MODULES_CATALOG.md` to select shared modules using template context. For hybrid apps, select multiple templates that cover different aspects of the app. **The module list feeds directly into Step 1 (architecture planning).**
 3. **Design Brand Selection** — follow `design-selector` skill. Read `designs/DESIGN_CATALOG.md` and select the best brand.
-4. **Module Selection** — follow `module-selector` skill. Read `templates/shared/MODULES_CATALOG.md` and select which shared modules to include. Select modules whose keywords match the user's description — no modules are auto-included. **The output of this step feeds directly into Step 1 (architecture planning).**
 
-Wait for all four. If prompt validation FAILS: stop immediately.
+Wait for all three. If prompt validation FAILS: stop immediately.
 
 This step also creates the `reports/` directory and initializes `summary.json` with `mode: "scratch"`.
 

package/templates/android/BookTemplate/app/src/main/kotlin/com/appship/book/core/animation/AnimatedTransitionsModifiers.kt

@@ -1,14 +1,24 @@
 package com.appship.book.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/ChatTemplate/app/src/main/kotlin/com/appship/chat/core/animation/AnimatedTransitionsModifiers.kt

@@ -1,14 +1,24 @@
 package com.appship.chat.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/ChatTemplate/app/src/main/kotlin/com/appship/chat/features/conversations/ConversationsScreen.kt

@@ -129,7 +129,7 @@ fun ConversationsScreen(onChatClick: (String) -> Unit) {
 }
 
 @Composable
-fun ConversationRow(conversation: Conversation, repository: com.appship.chat.data.DataRepository, onClick: () -> Unit, index: Int) {
+fun ConversationRow(conversation: Conversation, repository: com.appship.chat.data.DataRepository, onClick: () -> Unit, index: Int, modifier: Modifier = Modifier) {
     Row(
         modifier = Modifier
             .fillMaxWidth()

package/templates/android/DashTemplate/app/src/main/kotlin/com/appship/dash/core/animation/AnimatedTransitionsModifiers.kt

@@ -1,14 +1,24 @@
 package com.appship.dash.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/DashTemplate/app/src/main/kotlin/com/appship/dash/features/navigation/MainScreen.kt

@@ -15,6 +15,7 @@ import com.appship.dash.features.alerts.AlertsScreen
 import com.appship.dash.features.dashboard.DashboardScreen
 import com.appship.dash.features.settings.SettingsScreen
 
+@OptIn(ExperimentalMaterial3Api::class)
 @Composable
 fun MainScreen() {
     var selectedTab by remember { mutableStateOf(0) }