skills

1# Gradle setup templates
2 
3All version placeholders (`<PLACEHOLDER>`) must be filled from research done in SKILL.md Step 1: never from memorized numbers, since these move frequently and have compatibility constraints
4between each other.
5 
6## gradle/libs.versions.toml (version catalog)
7 
8```toml
9[versions]
10agp = "<AGP_VERSION>"
11kotlin = "<KOTLIN_VERSION>"
12composeBom = "<COMPOSE_BOM_VERSION>"
13coreKtx = "<CORE_KTX_VERSION>"
14lifecycleRuntimeKtx = "<LIFECYCLE_VERSION>"
15activityCompose = "<ACTIVITY_COMPOSE_VERSION>"
16navigationCompose = "<NAV_COMPOSE_VERSION>"
17room = "<ROOM_VERSION>"
18hilt = "<HILT_VERSION>"
19 
20[libraries]
21androidx-core-ktx = { group = "androidx.core", name = "core-ktx", version.ref = "coreKtx" }
22androidx-lifecycle-runtime-ktx = { group = "androidx.lifecycle", name = "lifecycle-runtime-ktx", version.ref = "lifecycleRuntimeKtx" }
23androidx-activity-compose = { group = "androidx.activity", name = "activity-compose", version.ref = "activityCompose" }
24androidx-compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "composeBom" }
25androidx-ui = { group = "androidx.compose.ui", name = "ui" }
26androidx-ui-graphics = { group = "androidx.compose.ui", name = "ui-graphics" }
27androidx-ui-tooling-preview = { group = "androidx.compose.ui", name = "ui-tooling-preview" }
28androidx-material3 = { group = "androidx.compose.material3", name = "material3" }
29androidx-navigation-compose = { group = "androidx.navigation", name = "navigation-compose", version.ref = "navigationCompose" }
30androidx-room-runtime = { group = "androidx.room", name = "room-runtime", version.ref = "room" }
31androidx-room-ktx = { group = "androidx.room", name = "room-ktx", version.ref = "room" }
32androidx-room-compiler = { group = "androidx.room", name = "room-compiler", version.ref = "room" }
33hilt-android = { group = "com.google.dagger", name = "hilt-android", version.ref = "hilt" }
34hilt-compiler = { group = "com.google.dagger", name = "hilt-compiler", version.ref = "hilt" }
35 
36[plugins]
37android-application = { id = "com.android.application", version.ref = "agp" }
38kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
39# Compose compiler is a Kotlin-versioned Gradle plugin since Kotlin 2.0: do NOT use the
40# older composeOptions { kotlinCompilerExtensionVersion = "..." } pattern for Kotlin 2.0+.
41compose-compiler = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }
42kotlin-ksp = { id = "com.google.devtools.ksp", version = "<KSP_VERSION_MATCHING_KOTLIN>" }
43hilt-android-gradle = { id = "com.google.dagger.hilt.android", version.ref = "hilt" }
44```
45 
46Note on KSP: its version string is tied to the exact Kotlin version (format like
47`<kotlin_version>-<ksp_version>`): search `ksp version <kotlin_version>` to find the matching
48release rather than guessing, since a mismatched KSP/Kotlin pairing fails immediately at sync.
49 
50## Project-level build.gradle.kts
51 
52```kotlin
53plugins {
54    alias(libs.plugins.android.application) apply false
55    alias(libs.plugins.kotlin.android) apply false
56    alias(libs.plugins.compose.compiler) apply false
57    alias(libs.plugins.kotlin.ksp) apply false
58    alias(libs.plugins.hilt.android.gradle) apply false
59}
60```
61 
62## app/build.gradle.kts
63 
64```kotlin
65plugins {
66    alias(libs.plugins.android.application)
67    alias(libs.plugins.kotlin.android)
68    alias(libs.plugins.compose.compiler)
69    alias(libs.plugins.kotlin.ksp)
70    alias(libs.plugins.hilt.android.gradle)
71}
72 
73android {
74    namespace = "com.example.app"
75    compileSdk = <COMPILE_SDK_INT>
76 
77    defaultConfig {
78        applicationId = "com.example.app"
79        minSdk = <MIN_SDK_INT>
80        targetSdk = <TARGET_SDK_INT>
81        versionCode = 1
82        versionName = "1.0"
83    }
84 
85    buildTypes {
86        release {
87            isMinifyEnabled = true
88            proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
89        }
90    }
91 
92    buildFeatures {
93        compose = true
94    }
95 
96    compileOptions {
97        sourceCompatibility = JavaVersion.VERSION_17
98        targetCompatibility = JavaVersion.VERSION_17
99    }
100 
101    kotlinOptions {
102        jvmTarget = "17"
103    }
104}
105 
106// Compose compiler options (Kotlin 2.0+ Gradle-plugin style), NOT the legacy
107// composeOptions { kotlinCompilerExtensionVersion = ... } block:
108composeCompiler {
109    // reportsDestination / stabilityConfigurationFile etc are optional; check current docs
110    // if the project needs Compose compiler metrics or stability configuration.
111}
112 
113dependencies {
114    implementation(libs.androidx.core.ktx)
115    implementation(libs.androidx.lifecycle.runtime.ktx)
116    implementation(libs.androidx.activity.compose)
117 
118    implementation(platform(libs.androidx.compose.bom))
119    implementation(libs.androidx.ui)
120    implementation(libs.androidx.ui.graphics)
121    implementation(libs.androidx.ui.tooling.preview)
122    implementation(libs.androidx.material3)
123    implementation(libs.androidx.navigation.compose)
124 
125    implementation(libs.androidx.room.runtime)
126    implementation(libs.androidx.room.ktx)
127    ksp(libs.androidx.room.compiler)
128 
129    implementation(libs.hilt.android)
130    ksp(libs.hilt.compiler)
131}
132```
133 
134## Notes
135 
136- Prefer `platform(libs.androidx.compose.bom)` (the Compose BOM) over pinning each
137  `androidx.compose.*` artifact's version individually: the BOM guarantees mutually compatible
138  versions across all Compose libraries.
139- `minSdk`/`targetSdk`/`compileSdk` should reflect what was found in Step 1's research, not
140  memorized numbers: Play Store's minimum targetSdk requirement changes roughly yearly.
141- Java 17 is the current common baseline for `sourceCompatibility`/`jvmTarget`, but confirm
142  against the AGP version's documented supported JDK range if unsure, since this has shifted
143  across AGP releases too.
144