Summary
The project uses Coil 2.5.0 (io.coil-kt:coil-compose). Coil 3.0 is now stable and is a major version bump with breaking changes that also bring significant improvements.
Key Changes in Coil 3
- Multiplatform support — Coil 3 supports Kotlin Multiplatform (KMP), enabling future Desktop/Web targets.
- Improved performance — Faster image loading and better memory management.
- New artifact group:
io.coil-kt.coil3:coil-compose (note the coil3 group ID).
- OkHttp is now optional: Coil 3 uses Ktor or OkHttp interchangeably;
coil-network-okhttp sub-artifact needed to keep OkHttp.
- Breaking API changes:
AsyncImage API is largely the same but ImageLoader configuration has changed.
Proposed Changes
- In
Versions.kt, update:
const val coilCompose = "3.x.x" // e.g. "3.1.0"
- In
Dependencies.kt, update the artifact group:
const val coilCompose = "io.coil-kt.coil3:coil-compose:${Versions.coilCompose}"
const val coilNetworkOkHttp = "io.coil-kt.coil3:coil-network-okhttp:${Versions.coilCompose}"
- Add
coilNetworkOkHttp to GroupedDependencies.kt alongside coilCompose.
- Update any call sites that use deprecated Coil 2 APIs.
- Ensure all demo screens that load images (Instagram, Movies, Crypto, etc.) still function correctly.
References
Summary
The project uses Coil 2.5.0 (
io.coil-kt:coil-compose). Coil 3.0 is now stable and is a major version bump with breaking changes that also bring significant improvements.Key Changes in Coil 3
io.coil-kt.coil3:coil-compose(note thecoil3group ID).coil-network-okhttpsub-artifact needed to keep OkHttp.AsyncImageAPI is largely the same butImageLoaderconfiguration has changed.Proposed Changes
Versions.kt, update:Dependencies.kt, update the artifact group:coilNetworkOkHttptoGroupedDependencies.ktalongsidecoilCompose.References