
Turn UI composables into store-ready screenshots, rendered headlessly and exported at exact store sizes; validate rules, generate visual diffs and HTML reports, CI-friendly with IDE-integrated publishing.
Store screenshots as code for Jetpack Compose and Compose Multiplatform.
Render Google Play and App Store assets from your composables, without an emulator, then export,
validate, review and publish them.
[!WARNING] Chameleon Store Studio is experimental until 1.0.0: the DSL, annotations and generated file formats may change between
0.xreleases. App Store Connect publishing has not been tested against the real store yet.
[!NOTE] Chameleon Store Studio is heavily inspired by compose-nav-graph by @skydoves. Its approach of turning Compose code into reviewable artifacts, with a Gradle plugin that generates them and an IDE tool window that displays them, shaped this project from the start. Thank you!
Store screenshots are usually made by hand: run the app, capture the screen, add headlines and frames in a design tool, then repeat for every store size and language. They're rejected for small rule violations, and they quietly drift away from the real app after every redesign.
Chameleon Store Studio makes them part of your codebase:
@Composable that reuses your real screens, theme and
string resources.| Component | Description |
|---|---|
dev.ribod.storestudio (Gradle plugin) |
Discovers, renders, exports, validates, diffs, reports and publishes. |
store-studio-annotations |
@StoreScreenshot and @StoreFeatureGraphic. |
store-studio-ksp |
Compile-time checks and screenshot manifest. |
store-studio-runtime |
Canvas, headlines, device mockups, status bars (off by default) and backgrounds (KMP). |
store-studio-testing |
Robolectric harness for the fallback renderer. |
| IDE plugin | Tool window for Android Studio and IntelliJ IDEA. |
1. Add the plugins. Everything is on Maven Central, so mavenCentral() must be in
pluginManagement and dependencyResolutionManagement (Android Studio projects already have it).
Store Studio adds its libraries and the KSP processor for you.
// build.gradle.kts (root)
plugins {
id("com.google.devtools.ksp") version "2.3.12" apply false
id("dev.ribod.storestudio") version "0.1.0" apply false
}
// app/build.gradle.kts
plugins {
id("com.android.application")
id("org.jetbrains.kotlin.plugin.compose")
id("com.google.devtools.ksp")
id("dev.ribod.storestudio")
}2. Configure stores and languages.
storeStudio {
targets.set(setOf(StoreTarget.PLAY_STORE, StoreTarget.APP_STORE))
defaultDevices.set(setOf(DeviceFamily.PHONE, DeviceFamily.TABLET))
locales {
register("en-US")
register("es-MX") { playStore.set("es-419") }
}
}3. Write a screenshot.
@StoreScreenshot(id = "agenda", order = 1, name = "Conference Schedule")
@Composable
fun AgendaStoreScreenshot() {
StoreScreenshotCanvas {
Headline(stringResource(Res.string.agenda_headline))
Subheadline(stringResource(Res.string.agenda_subheadline))
DeviceMockup { AppTheme { AgendaScreen(state = AgendaState.sample()) } }
}
}4. Export and validate.
./gradlew :app:storeExport # app/build/store/export/
./gradlew :app:storeValidate # Google Play and App Store rulesRead the Quick Start for the full walkthrough.
Every screenshot is rendered for each store slot and locale, then exported at the exact size the store expects (Google Play phone, 7" and 10" tablets, Wear OS and the 1024×500 feature graphic; App Store iPhone 6.9", 6.5" and iPad 13"), without transparency and within file size limits. Rendering · Export
About fifty rules cover dimensions, formats, screenshot counts, required device sets, locale coverage, text overflow and listing text limits. Hard store requirements always fail the build; everything else is configurable. Validation
storeDiff --render-base renders the base branch on the same machine and compares exactly, pixels and
captured text, so pull requests show every screenshot change without committing a baseline. It
produces an HTML report with slider, onion-skin and difference views. A hash-only committed baseline is
also supported.
Self-contained HTML reports, ready to share: a gallery, a simulation of the Google Play and App Store listings, and the visual diff.
storeCi validates and diffs in one task, writes a GitHub Actions job summary and keeps a sticky
comment on the pull request (GitHub and GitLab). Renders are cacheable in the Gradle build cache.
CI Integration
Publishing supports granular and full-release scopes with --publish-dry-run and automated safety checks:
storePublishPlay performs the entire release (AAB, R8 mapping, track release & release notes, localized descriptions, and visual assets) inside a single atomic Google Play Edit and commits once (storePublish deploys across all configured stores).storePublishPlayListing (or storePublishListing). Granular tasks (storePublishPlayTexts, storePublishPlayImages, storePublishPlayReleaseNotes) allow updating individual listing parts.storePublishPlayBinary (or storePublishBinary).Google Play publishing (binary, metadata, and visual assets) is verified end-to-end in production; App Store Connect publishing is available as an experimental feature. Publishing · Binary publishing
Write screenshots once in commonMain with Compose Multiplatform resources, and keep them in feature
modules: the application module merges them all.
Kotlin Multiplatform ·
Multi-Module Projects
The Store Studio tool window for Android Studio and IntelliJ IDEA shows the gallery with filters and badges, a store listing preview, the diff and validation results. Double-click any image to open its composable. Install it from the GitHub releases until it's available on the JetBrains Marketplace. IDE Plugin
JDK 17+ for the Gradle plugin and libraries, JDK 21 to build the IDE plugin from source, Gradle 9.3+, Kotlin 2.4, Android Gradle Plugin 9.1, KSP 2.3, min SDK 24. The IDE plugin requires Android Studio or IntelliJ IDEA 2024.2+.
samples/sample-kotlinconf: Compose Multiplatform, both stores,
English and Spanish.samples/sample-nowinandroid: multi-module app with store metadata.Copyright 2026 ribod
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Store screenshots as code for Jetpack Compose and Compose Multiplatform.
Render Google Play and App Store assets from your composables, without an emulator, then export,
validate, review and publish them.
[!WARNING] Chameleon Store Studio is experimental until 1.0.0: the DSL, annotations and generated file formats may change between
0.xreleases. App Store Connect publishing has not been tested against the real store yet.
[!NOTE] Chameleon Store Studio is heavily inspired by compose-nav-graph by @skydoves. Its approach of turning Compose code into reviewable artifacts, with a Gradle plugin that generates them and an IDE tool window that displays them, shaped this project from the start. Thank you!
Store screenshots are usually made by hand: run the app, capture the screen, add headlines and frames in a design tool, then repeat for every store size and language. They're rejected for small rule violations, and they quietly drift away from the real app after every redesign.
Chameleon Store Studio makes them part of your codebase:
@Composable that reuses your real screens, theme and
string resources.| Component | Description |
|---|---|
dev.ribod.storestudio (Gradle plugin) |
Discovers, renders, exports, validates, diffs, reports and publishes. |
store-studio-annotations |
@StoreScreenshot and @StoreFeatureGraphic. |
store-studio-ksp |
Compile-time checks and screenshot manifest. |
store-studio-runtime |
Canvas, headlines, device mockups, status bars (off by default) and backgrounds (KMP). |
store-studio-testing |
Robolectric harness for the fallback renderer. |
| IDE plugin | Tool window for Android Studio and IntelliJ IDEA. |
1. Add the plugins. Everything is on Maven Central, so mavenCentral() must be in
pluginManagement and dependencyResolutionManagement (Android Studio projects already have it).
Store Studio adds its libraries and the KSP processor for you.
// build.gradle.kts (root)
plugins {
id("com.google.devtools.ksp") version "2.3.12" apply false
id("dev.ribod.storestudio") version "0.1.0" apply false
}
// app/build.gradle.kts
plugins {
id("com.android.application")
id("org.jetbrains.kotlin.plugin.compose")
id("com.google.devtools.ksp")
id("dev.ribod.storestudio")
}2. Configure stores and languages.
storeStudio {
targets.set(setOf(StoreTarget.PLAY_STORE, StoreTarget.APP_STORE))
defaultDevices.set(setOf(DeviceFamily.PHONE, DeviceFamily.TABLET))
locales {
register("en-US")
register("es-MX") { playStore.set("es-419") }
}
}3. Write a screenshot.
@StoreScreenshot(id = "agenda", order = 1, name = "Conference Schedule")
@Composable
fun AgendaStoreScreenshot() {
StoreScreenshotCanvas {
Headline(stringResource(Res.string.agenda_headline))
Subheadline(stringResource(Res.string.agenda_subheadline))
DeviceMockup { AppTheme { AgendaScreen(state = AgendaState.sample()) } }
}
}4. Export and validate.
./gradlew :app:storeExport # app/build/store/export/
./gradlew :app:storeValidate # Google Play and App Store rulesRead the Quick Start for the full walkthrough.
Every screenshot is rendered for each store slot and locale, then exported at the exact size the store expects (Google Play phone, 7" and 10" tablets, Wear OS and the 1024×500 feature graphic; App Store iPhone 6.9", 6.5" and iPad 13"), without transparency and within file size limits. Rendering · Export
About fifty rules cover dimensions, formats, screenshot counts, required device sets, locale coverage, text overflow and listing text limits. Hard store requirements always fail the build; everything else is configurable. Validation
storeDiff --render-base renders the base branch on the same machine and compares exactly, pixels and
captured text, so pull requests show every screenshot change without committing a baseline. It
produces an HTML report with slider, onion-skin and difference views. A hash-only committed baseline is
also supported.
Self-contained HTML reports, ready to share: a gallery, a simulation of the Google Play and App Store listings, and the visual diff.
storeCi validates and diffs in one task, writes a GitHub Actions job summary and keeps a sticky
comment on the pull request (GitHub and GitLab). Renders are cacheable in the Gradle build cache.
CI Integration
Publishing supports granular and full-release scopes with --publish-dry-run and automated safety checks:
storePublishPlay performs the entire release (AAB, R8 mapping, track release & release notes, localized descriptions, and visual assets) inside a single atomic Google Play Edit and commits once (storePublish deploys across all configured stores).storePublishPlayListing (or storePublishListing). Granular tasks (storePublishPlayTexts, storePublishPlayImages, storePublishPlayReleaseNotes) allow updating individual listing parts.storePublishPlayBinary (or storePublishBinary).Google Play publishing (binary, metadata, and visual assets) is verified end-to-end in production; App Store Connect publishing is available as an experimental feature. Publishing · Binary publishing
Write screenshots once in commonMain with Compose Multiplatform resources, and keep them in feature
modules: the application module merges them all.
Kotlin Multiplatform ·
Multi-Module Projects
The Store Studio tool window for Android Studio and IntelliJ IDEA shows the gallery with filters and badges, a store listing preview, the diff and validation results. Double-click any image to open its composable. Install it from the GitHub releases until it's available on the JetBrains Marketplace. IDE Plugin
JDK 17+ for the Gradle plugin and libraries, JDK 21 to build the IDE plugin from source, Gradle 9.3+, Kotlin 2.4, Android Gradle Plugin 9.1, KSP 2.3, min SDK 24. The IDE plugin requires Android Studio or IntelliJ IDEA 2024.2+.
samples/sample-kotlinconf: Compose Multiplatform, both stores,
English and Spanish.samples/sample-nowinandroid: multi-module app with store metadata.Copyright 2026 ribod
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.