@shaykec/app-agent 1.0.0

package/templates/android/ICON_VECTORS.md

@@ -0,0 +1,420 @@
+# Android App Icon Vector Library
+
+Ready-to-use `ic_launcher_foreground.xml` vector drawables for common app domains. The android-customizer agent selects the best match and copies the XML into the output app.
+
+All icons use the standard Android adaptive icon viewport: **108dp x 108dp** with a **66dp safe zone** (centered from 21 to 87). Icons are drawn in **white (#FFFFFF)** to sit on a colored background.
+
+## How to Use
+
+1. Select the domain keyword that best matches the app
+2. Copy the full XML into `app/src/main/res/drawable/ic_launcher_foreground.xml`
+3. Set `ic_launcher_background` in `colors.xml` to the app's primary color
+
+---
+
+## shopping
+
+Shopping bag — e-commerce, retail, marketplace apps.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp" android:height="108dp"
+    android:viewportWidth="108" android:viewportHeight="108">
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M34,42 L34,78 C34,80.2 35.8,82 38,82 L70,82 C72.2,82 74,80.2 74,78 L74,42 C74,39.8 72.2,38 70,38 L38,38 C35.8,38 34,39.8 34,42 Z"/>
+    <path android:fillColor="@android:color/transparent"
+        android:strokeColor="#FFFFFF" android:strokeWidth="4"
+        android:pathData="M44,38 L44,32 C44,26.5 48.5,22 54,22 C59.5,22 64,26.5 64,32 L64,38"/>
+</vector>
+```
+
+## task
+
+Checkmark in circle — to-do, productivity, task management apps.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp" android:height="108dp"
+    android:viewportWidth="108" android:viewportHeight="108">
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M54,22 C36.3,22 22,36.3 22,54 C22,71.7 36.3,86 54,86 C71.7,86 86,71.7 86,54 C86,36.3 71.7,22 54,22 Z"/>
+    <path android:fillColor="@android:color/transparent"
+        android:strokeColor="#1976D2" android:strokeWidth="5"
+        android:strokeLineCap="round" android:strokeLineJoin="round"
+        android:pathData="M38,54 L50,66 L70,42"/>
+</vector>
+```
+
+**Note:** Replace the checkmark stroke color with the app's primary color.
+
+## health
+
+Heart — health, wellness, medical, fitness apps.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp" android:height="108dp"
+    android:viewportWidth="108" android:viewportHeight="108">
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M54,82 L50.2,78.5 C34,63.8 24,54.8 24,43.5 C24,34.5 31,27.5 40,27.5 C45.1,27.5 50,30 54,33.9 C58,30 62.9,27.5 68,27.5 C77,27.5 84,34.5 84,43.5 C84,54.8 74,63.8 57.8,78.5 L54,82 Z"/>
+</vector>
+```
+
+## chat
+
+Chat bubble — messaging, communication, support apps.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp" android:height="108dp"
+    android:viewportWidth="108" android:viewportHeight="108">
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M24,30 C24,27.8 25.8,26 28,26 L80,26 C82.2,26 84,27.8 84,30 L84,66 C84,68.2 82.2,70 80,70 L44,70 L32,82 L32,70 L28,70 C25.8,70 24,68.2 24,66 L24,30 Z"/>
+</vector>
+```
+
+## map
+
+Map pin — location, maps, navigation, travel apps.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp" android:height="108dp"
+    android:viewportWidth="108" android:viewportHeight="108">
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M54,22 C40.2,22 29,33.2 29,47 C29,65.2 54,86 54,86 C54,86 79,65.2 79,47 C79,33.2 67.8,22 54,22 Z"/>
+    <path android:fillColor="#FF9800"
+        android:pathData="M54,38 C49,38 45,42 45,47 C45,52 49,56 54,56 C59,56 63,52 63,47 C63,42 59,38 54,38 Z"/>
+</vector>
+```
+
+**Note:** Replace the inner circle color with the app's primary color.
+
+## media
+
+Play button in circle — media, video, streaming, podcast apps.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp" android:height="108dp"
+    android:viewportWidth="108" android:viewportHeight="108">
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M54,22 C36.3,22 22,36.3 22,54 C22,71.7 36.3,86 54,86 C71.7,86 86,71.7 86,54 C86,36.3 71.7,22 54,22 Z"/>
+    <path android:fillColor="#F44336"
+        android:pathData="M46,40 L46,68 L72,54 Z"/>
+</vector>
+```
+
+**Note:** Replace the play triangle color with the app's primary color.
+
+## finance
+
+Dollar sign in circle — finance, banking, wallet, payment apps.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp" android:height="108dp"
+    android:viewportWidth="108" android:viewportHeight="108">
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M54,22 C36.3,22 22,36.3 22,54 C22,71.7 36.3,86 54,86 C71.7,86 86,71.7 86,54 C86,36.3 71.7,22 54,22 Z"/>
+    <path android:fillColor="#2E7D32" android:strokeColor="#2E7D32" android:strokeWidth="1"
+        android:pathData="M56,34 L52,34 L52,38.5 C47,39.2 43,42.5 43,47 C43,52.5 47.5,55 54,56.5 C60,58 62,59.5 62,62 C62,65 59,67 55,67 C50.5,67 47,65 44.5,62.5 L40,66.5 C43,69.5 47,71.5 52,72 L52,76 L56,76 L56,72 C61.5,71 66,67.2 66,62 C66,56 61,53.5 54,52 C49,50.8 47,49 47,47 C47,44.5 49.5,42.5 53.5,42.5 C57,42.5 60,44 62,46 L65.5,42 C63,39.5 59.5,38 56,37.5 L56,34 Z"/>
+</vector>
+```
+
+**Note:** Replace the dollar sign color with the app's primary color.
+
+## social
+
+Two people — social network, community, friends apps.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp" android:height="108dp"
+    android:viewportWidth="108" android:viewportHeight="108">
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M44,38 C44,32.5 48.5,28 54,28 C59.5,28 64,32.5 64,38 C64,43.5 59.5,48 54,48 C48.5,48 44,43.5 44,38 Z"/>
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M34,72 C34,62 42.9,54 54,54 C65.1,54 74,62 74,72 L74,76 L34,76 L34,72 Z"/>
+    <path android:fillColor="#BBBBBB"
+        android:pathData="M66,34 C66,29.6 69.6,26 74,26 C78.4,26 82,29.6 82,34 C82,38.4 78.4,42 74,42 C69.6,42 66,38.4 66,34 Z"/>
+    <path android:fillColor="#BBBBBB"
+        android:pathData="M66,66 C66,58.3 71.4,52 78,52 C82,52 85.5,54.2 88,57.5 L88,70 L66,70 L66,66 Z"/>
+</vector>
+```
+
+## book
+
+Open book — reading, library, education, content apps.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp" android:height="108dp"
+    android:viewportWidth="108" android:viewportHeight="108">
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M54,36 L54,78 L26,72 L26,30 C26,28 28,26 30,26 L54,30 L54,36 Z"/>
+    <path android:fillColor="#DDDDDD"
+        android:pathData="M54,36 L54,78 L82,72 L82,30 C82,28 80,26 78,26 L54,30 L54,36 Z"/>
+    <path android:fillColor="@android:color/transparent"
+        android:strokeColor="#795548" android:strokeWidth="2"
+        android:pathData="M54,30 L54,78"/>
+</vector>
+```
+
+**Note:** Replace the spine color with the app's primary color.
+
+## game
+
+Gamepad — gaming, arcade, puzzle apps.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp" android:height="108dp"
+    android:viewportWidth="108" android:viewportHeight="108">
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M30,42 C26,42 22,46 22,50 L22,66 C22,70 26,74 30,74 L38,74 L42,82 L46,74 L62,74 L66,82 L70,74 L78,74 C82,74 86,70 86,66 L86,50 C86,46 82,42 78,42 Z"/>
+    <path android:fillColor="#FF5722"
+        android:pathData="M32,55 L46,55 L46,61 L32,61 Z"/>
+    <path android:fillColor="#FF5722"
+        android:pathData="M36,49 L42,49 L42,67 L36,67 Z"/>
+    <path android:fillColor="#FF5722"
+        android:pathData="M68,52 C68,49.2 70.2,47 73,47 C75.8,47 78,49.2 78,52 C78,54.8 75.8,57 73,57 C70.2,57 68,54.8 68,52 Z"/>
+    <path android:fillColor="#FF5722"
+        android:pathData="M60,60 C60,57.2 62.2,55 65,55 C67.8,55 70,57.2 70,60 C70,62.8 67.8,65 65,65 C62.2,65 60,62.8 60,60 Z"/>
+</vector>
+```
+
+**Note:** Replace the d-pad and button colors with the app's primary color.
+
+## tracking
+
+Bar chart — habit tracking, analytics, progress, statistics apps.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp" android:height="108dp"
+    android:viewportWidth="108" android:viewportHeight="108">
+    <path android:fillColor="#FFFFFF" android:pathData="M28,58 L38,58 L38,80 L28,80 Z"/>
+    <path android:fillColor="#FFFFFF" android:pathData="M42,38 L52,38 L52,80 L42,80 Z"/>
+    <path android:fillColor="#FFFFFF" android:pathData="M56,48 L66,48 L66,80 L56,80 Z"/>
+    <path android:fillColor="#FFFFFF" android:pathData="M70,28 L80,28 L80,80 L70,80 Z"/>
+</vector>
+```
+
+## dashboard
+
+Grid squares — dashboard, overview, admin apps.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp" android:height="108dp"
+    android:viewportWidth="108" android:viewportHeight="108">
+    <path android:fillColor="#FFFFFF" android:pathData="M24,24 L50,24 L50,50 L24,50 Z"/>
+    <path android:fillColor="#CCCCCC" android:pathData="M58,24 L84,24 L84,50 L58,50 Z"/>
+    <path android:fillColor="#CCCCCC" android:pathData="M24,58 L50,58 L50,84 L24,84 Z"/>
+    <path android:fillColor="#FFFFFF" android:pathData="M58,58 L84,58 L84,84 L58,84 Z"/>
+</vector>
+```
+
+## education
+
+Graduation cap — learning, courses, school, tutorial apps.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp" android:height="108dp"
+    android:viewportWidth="108" android:viewportHeight="108">
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M54,28 L22,46 L54,64 L86,46 Z"/>
+    <path android:fillColor="#DDDDDD"
+        android:pathData="M34,52 L34,72 C34,72 43,80 54,80 C65,80 74,72 74,72 L74,52 L54,64 Z"/>
+    <path android:fillColor="@android:color/transparent"
+        android:strokeColor="#FFFFFF" android:strokeWidth="3"
+        android:pathData="M82,46 L82,72"/>
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M79,72 L85,72 L82,78 Z"/>
+</vector>
+```
+
+## house
+
+House — family, home, real estate, property apps.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp" android:height="108dp"
+    android:viewportWidth="108" android:viewportHeight="108">
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M54,24 L22,54 L30,54 L30,82 L78,82 L78,54 L86,54 Z"/>
+    <path android:fillColor="#26A69A"
+        android:pathData="M48,60 L60,60 L60,82 L48,82 Z"/>
+    <path android:fillColor="#26A69A"
+        android:pathData="M34,58 L44,58 L44,68 L34,68 Z"/>
+    <path android:fillColor="#26A69A"
+        android:pathData="M64,58 L74,58 L74,68 L64,68 Z"/>
+</vector>
+```
+
+**Note:** Replace the door and window colors with the app's primary color.
+
+## star
+
+Star — reference, favorites, ratings, general-purpose apps.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp" android:height="108dp"
+    android:viewportWidth="108" android:viewportHeight="108">
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M54,24 L62.2,44.5 L84,46.8 L68,62.2 L72.4,84 L54,73 L35.6,84 L40,62.2 L24,46.8 L45.8,44.5 Z"/>
+</vector>
+```
+
+## food
+
+Fork and knife — food, restaurant, recipe, cooking apps.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp" android:height="108dp"
+    android:viewportWidth="108" android:viewportHeight="108">
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M40,24 L40,44 C40,48 44,52 48,52 L48,84 L52,84 L52,52 C56,52 60,48 60,44 L60,24"/>
+    <path android:fillColor="@android:color/transparent"
+        android:strokeColor="#FFFFFF" android:strokeWidth="3"
+        android:pathData="M44,24 L44,40 M48,24 L48,40 M52,24 L52,40 M56,24 L56,40"/>
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M66,24 C66,24 64,36 64,48 C64,54 68,58 72,58 L72,84 L76,84 L76,24 Z"/>
+</vector>
+```
+
+## camera
+
+Camera — photography, image editing, photo sharing apps.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp" android:height="108dp"
+    android:viewportWidth="108" android:viewportHeight="108">
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M42,32 L38,38 L28,38 C25.8,38 24,39.8 24,42 L24,74 C24,76.2 25.8,78 28,78 L80,78 C82.2,78 84,76.2 84,74 L84,42 C84,39.8 82.2,38 80,38 L70,38 L66,32 Z"/>
+    <path android:fillColor="@android:color/transparent"
+        android:strokeColor="#9E9E9E" android:strokeWidth="4"
+        android:pathData="M54,48 C60.6,48 66,53.4 66,60 C66,66.6 60.6,72 54,72 C47.4,72 42,66.6 42,60 C42,53.4 47.4,48 54,48 Z"/>
+</vector>
+```
+
+**Note:** Replace the lens circle stroke color with the app's primary color.
+
+## music
+
+Music note — music, audio, radio, podcast apps.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp" android:height="108dp"
+    android:viewportWidth="108" android:viewportHeight="108">
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M44,72 C44,76.4 40.4,80 36,80 C31.6,80 28,76.4 28,72 C28,67.6 31.6,64 36,64 C37.4,64 38.8,64.4 40,65 L40,28 L76,24 L76,64 C76,68.4 72.4,72 68,72 C63.6,72 60,68.4 60,64 C60,59.6 63.6,56 68,56 C69.4,56 70.8,56.4 72,57 L72,32 L44,34 Z"/>
+</vector>
+```
+
+## fitness
+
+Running person — fitness, exercise, workout, sports apps.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp" android:height="108dp"
+    android:viewportWidth="108" android:viewportHeight="108">
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M62,30 C62,26.7 64.7,24 68,24 C71.3,24 74,26.7 74,30 C74,33.3 71.3,36 68,36 C64.7,36 62,33.3 62,30 Z"/>
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M56,44 L46,54 L54,62 L46,84 L52,84 L58,66 L66,74 L66,84 L72,84 L72,70 L60,58 L66,50 L76,54 L78,48 L64,40 Z"/>
+</vector>
+```
+
+## travel
+
+Airplane — travel, flights, vacation, booking apps.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp" android:height="108dp"
+    android:viewportWidth="108" android:viewportHeight="108">
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M78,30 C80.2,30 82,31.8 82,34 L82,38 L58,54 L58,74 L54,78 L50,74 L50,54 L26,38 L26,34 C26,31.8 27.8,30 30,30 L50,42 L50,28 L44,22 L44,18 L54,24 L64,18 L64,22 L58,28 L58,42 Z"/>
+</vector>
+```
+
+## pet
+
+Paw print — pet care, animal, veterinary apps.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp" android:height="108dp"
+    android:viewportWidth="108" android:viewportHeight="108">
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M54,54 C48,48 38,48 34,56 C30,64 38,72 46,72 C50,72 52,70 54,68 C56,70 58,72 62,72 C70,72 78,64 74,56 C70,48 60,48 54,54 Z"/>
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M36,38 C36,34 38.7,30 42,30 C45.3,30 48,34 48,38 C48,42 45.3,46 42,46 C38.7,46 36,42 36,38 Z"/>
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M60,38 C60,34 62.7,30 66,30 C69.3,30 72,34 72,38 C72,42 69.3,46 66,46 C62.7,46 60,42 60,38 Z"/>
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M24,52 C24,48 26.7,44 30,44 C33.3,44 36,48 36,52 C36,56 33.3,60 30,60 C26.7,60 24,56 24,52 Z"/>
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M72,52 C72,48 74.7,44 78,44 C81.3,44 84,48 84,52 C84,56 81.3,60 78,60 C74.7,60 72,56 72,52 Z"/>
+</vector>
+```
+
+## weather
+
+Sun — weather, climate, outdoor apps.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp" android:height="108dp"
+    android:viewportWidth="108" android:viewportHeight="108">
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M54,36 C44.1,36 36,44.1 36,54 C36,63.9 44.1,72 54,72 C63.9,72 72,63.9 72,54 C72,44.1 63.9,36 54,36 Z"/>
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M52,22 L56,22 L56,30 L52,30 Z"/>
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M52,78 L56,78 L56,86 L52,86 Z"/>
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M78,52 L86,52 L86,56 L78,56 Z"/>
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M22,52 L30,52 L30,56 L22,56 Z"/>
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M72.2,30.6 L75,27.8 L78.6,31.4 L75.8,34.2 Z"/>
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M29.4,73.4 L32.2,70.6 L35.8,74.2 L33,77 Z"/>
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M73.4,75.8 L70.6,73 L74.2,69.4 L77,72.2 Z"/>
+    <path android:fillColor="#FFFFFF"
+        android:pathData="M30.6,33 L27.8,30.2 L31.4,26.6 L34.2,29.4 Z"/>
+</vector>
+```

package/templates/android/LearnTemplate/README.md

@@ -0,0 +1,118 @@
+# LearnTemplate - Education Android App Template
+
+A complete, production-ready education/learning Android app template built with Jetpack Compose. This template provides everything you need to create a modern learning app.
+
+## Features
+
+### Core Learning
+- 📚 **Courses** - Browse courses by category, search, filter by difficulty
+- 📖 **Lessons** - Text, video, and interactive lesson types
+- ✅ **Quizzes** - Multiple choice, fill-in-blank, true/false, matching questions
+- 🧠 **Flashcards** - Spaced repetition flashcards with mastery tracking
+- 📊 **Progress** - XP system, levels, streaks, achievements
+
+### Gamification
+- 🏆 **Leaderboard** - Compete with other learners
+- ⭐ **Achievements** - Unlock achievements for milestones
+- 🔥 **Streaks** - Daily learning streaks with bonuses
+- 📈 **XP System** - Earn XP for lessons, quizzes, and streaks
+
+## Requirements
+
+- Android 8.0+ (API 26+)
+- Kotlin 1.9+
+- Gradle 8.0+
+- Android Studio Hedgehog+
+
+## Quick Start
+
+1. **Clone the template:**
+   ```bash
+   cp -R templates/android/LearnTemplate ~/MyLearnApp
+   cd ~/MyLearnApp
+   ```
+
+2. **Open in Android Studio:**
+   - File → Open → Select the project directory
+
+3. **Update Package Name:**
+   - Update `package` declarations in all Kotlin files
+   - Update `applicationId` in `build.gradle.kts`
+
+4. **Customize the app:**
+   - Edit `AppConfig.kt` to change app name, colors, API endpoints
+   - Replace mock data in `MockDataProvider.kt` with your API calls
+
+5. **Run the app:**
+   - Select an emulator or device
+   - Press Run
+
+## Customization Guide
+
+### Branding (AppConfig.kt)
+
+```kotlin
+// Change app identity
+const val APP_NAME = "Your Learning App"
+const val PACKAGE_NAME = "com.yourcompany.learn"
+
+// Change feature flags
+object Features {
+    const val ENABLE_QUIZZES = true
+    const val ENABLE_FLASHCARDS = true
+}
+```
+
+### API Integration
+
+Replace mock data with real API calls:
+
+1. Create API service classes
+2. Update `MockDataProvider.kt` methods to call your API
+3. Add authentication tokens
+
+## Project Structure
+
+```
+LearnTemplate/
+├── app/
+│   └── src/
+│       └── main/
+│           └── kotlin/com/appship/learn/
+│               ├── AppConfig.kt
+│               ├── MainActivity.kt
+│               ├── core/
+│               │   └── theme/
+│               ├── data/
+│               │   └── models/
+│               ├── features/
+│               │   ├── courses/
+│               │   ├── lessons/
+│               │   ├── quiz/
+│               │   ├── flashcards/
+│               │   ├── progress/
+│               │   ├── leaderboard/
+│               │   └── profile/
+│               └── mock/
+│                   └── MockDataProvider.kt
+```
+
+## Key Files for AI Agents
+
+When customizing this template, focus on these files:
+
+1. **`AppConfig.kt`** - All app configuration in one place
+2. **`MockDataProvider.kt`** - Replace with your API integration
+3. **`data/models/Models.kt`** - Data models
+4. **`core/theme/`** - Theme colors and typography
+
+## Testing
+
+The template includes:
+- Unit tests for MockDataProvider and Models
+- Maestro E2E tests covering all major flows
+- Test IDs following `{screen}_{element}_{role}` pattern
+
+## License
+
+This template is provided for use with AppShip. See LICENSE for details.

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

@@ -0,0 +1,96 @@
+plugins {
+    alias(libs.plugins.android.application)
+    alias(libs.plugins.kotlin.android)
+    alias(libs.plugins.hilt.android)
+    alias(libs.plugins.ksp)
+}
+
+android {
+    namespace = "com.appship.learn"
+    compileSdk = 34
+
+    defaultConfig {
+        // CUSTOMIZE:BRANDING - Update application ID
+        applicationId = "com.appship.learn"
+        minSdk = 26
+        targetSdk = 34
+        versionCode = 1
+        versionName = "1.0"
+
+        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
+    }
+
+    buildTypes {
+        release {
+            isMinifyEnabled = true
+            proguardFiles(
+                getDefaultProguardFile("proguard-android-optimize.txt"),
+                "proguard-rules.pro"
+            )
+        }
+        debug {
+            isMinifyEnabled = false
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_17
+        targetCompatibility = JavaVersion.VERSION_17
+    }
+
+    kotlinOptions {
+        jvmTarget = "17"
+    }
+
+    buildFeatures {
+        compose = true
+        buildConfig = true
+    }
+
+    composeOptions {
+        kotlinCompilerExtensionVersion = libs.versions.composeCompiler.get()
+    }
+}
+
+dependencies {
+    // Core Android
+    implementation(libs.androidx.core.ktx)
+    implementation(libs.androidx.lifecycle.runtime.ktx)
+    implementation(libs.androidx.activity.compose)
+
+    // Compose
+    implementation(platform(libs.androidx.compose.bom))
+    implementation(libs.androidx.ui)
+    implementation(libs.androidx.ui.graphics)
+    implementation(libs.androidx.ui.tooling.preview)
+    implementation(libs.androidx.material3)
+    implementation(libs.androidx.material.icons.extended)
+
+    // Navigation
+    implementation(libs.androidx.navigation.compose)
+    implementation(libs.androidx.hilt.navigation.compose)
+
+    // Hilt
+    implementation(libs.hilt.android)
+    ksp(libs.hilt.compiler)
+
+    // Image Loading
+    implementation(libs.coil.compose)
+
+    // Lifecycle
+    implementation(libs.androidx.lifecycle.viewmodel.compose)
+    implementation(libs.androidx.lifecycle.runtime.compose)
+
+    // JSON Serialization
+    implementation(libs.gson)
+
+    // Testing
+    testImplementation(libs.junit)
+    testImplementation(libs.kotlinx.coroutines.test)
+    androidTestImplementation(libs.androidx.junit)
+    androidTestImplementation(libs.androidx.espresso.core)
+    androidTestImplementation(platform(libs.androidx.compose.bom))
+    androidTestImplementation(libs.androidx.ui.test.junit4)
+    debugImplementation(libs.androidx.ui.tooling)
+    debugImplementation(libs.androidx.ui.test.manifest)
+}

package/templates/android/LearnTemplate/app/src/main/AndroidManifest.xml

@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+
+    <uses-permission android:name="android.permission.INTERNET" />
+
+    <application
+        android:allowBackup="true"
+        android:icon="@mipmap/ic_launcher"
+        android:label="@string/app_name"
+        android:roundIcon="@mipmap/ic_launcher_round"
+        android:supportsRtl="true"
+        android:theme="@style/Theme.LearnTemplate"
+        tools:targetApi="34">
+        <activity
+            android:name=".MainActivity"
+            android:exported="true"
+            android:theme="@style/Theme.LearnTemplate">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+    </application>
+</manifest>