How coil-kt/coil works
Coil is a multiplatform image-loading library for Android and Compose. Its main user workflow is to supply image data and display it with Compose’s AsyncImage; an ImageLoader coordinates request handling, cache lookup, fetching, decoding, transformations, and a result image. The repository also provides platform fetchers/decoders, network-client integrations, and optional GIF, SVG, and video support. Edges grounded in excerpts or the README are cited; links for documented but unsampled integrations are dashed and marked unverified.
Main entry points: EngineInterceptor.kt Engine Interceptor · ComponentRegistry.kt Component Registry · ImageLoader.kt ImageLoader · ServiceLoaderComponentRegistry.kt Service Loader
Components 21
Compose UI
- AsyncImage
coil-compose-core/src/commonMain/kotlin/coil3/compose/AsyncImage.kt - AsyncImagePainter
coil-compose-core/src/commonMain/kotlin/coil3/compose/AsyncImagePainter.kt
Loading Pipeline
- ImageLoader
coil-core/src/commonMain/kotlin/coil3/ImageLoader.kt - ImageRequest
coil-core/src/commonMain/kotlin/coil3/request/ImageRequest.kt - Request Service
coil-core/src/commonMain/kotlin/coil3/request/RequestService.kt - Engine Interceptor
coil-core/src/commonMain/kotlin/coil3/intercept/EngineInterceptor.kt - Component Registry
coil-core/src/commonMain/kotlin/coil3/ComponentRegistry.kt - Fetchers
coil-core/src/commonMain/kotlin/coil3/fetch/Fetcher.kt - Decoders
coil-core/src/commonMain/kotlin/coil3/decode/Decoder.kt - Transformations
coil-core/src/commonMain/kotlin/coil3/transform/Transformation.kt - Image Result
coil-core/src/commonMain/kotlin/coil3/Image.kt - Service Loader
coil-core/src/commonMain/kotlin/coil3/util/ServiceLoaderComponentRegistry.kt
Caching
- Memory Cache Service
coil-core/src/commonMain/kotlin/coil3/memory/MemoryCacheService.kt - Memory Cache
coil-core/src/commonMain/kotlin/coil3/memory/MemoryCache.kt - Disk Cache
coil-core/src/commonMain/kotlin/coil3/disk/DiskCache.kt
Platform Integrations
- Network Fetcher
coil-network-core/src/commonMain/kotlin/coil3/network/NetworkFetcher.kt - Network Clients
coil-network-core/src/commonMain/kotlin/coil3/network/NetworkClient.kt - GIF Decoder
coil-gif/src/main/java/coil3/gif/GifDecoder.kt - SVG Decoder
coil-svg/src/commonMain/kotlin/coil3/svg/internal/SvgDecoderServiceLoaderTarget.kt - Video Decoder
coil-video/src/main/java/coil3/video/VideoFrameDecoder.kt
Other components
- App developer
Connections 20
- App developer → AsyncImage: requests image
README.md - AsyncImage → AsyncImagePainter: renders with
- AsyncImagePainter → ImageLoader: executes request
coil-compose-core/src/commonMain/kotlin/coil3/compose/LocalAsyncImagePreviewHandler.kt - ImageLoader → Request Service: handles requests
coil-core/src/commonMain/kotlin/coil3/request/RequestService.kt - ImageLoader → Engine Interceptor: runs pipeline
coil-core/src/commonMain/kotlin/coil3/intercept/EngineInterceptor.kt - Engine Interceptor → Component Registry: selects components
coil-core/src/commonMain/kotlin/coil3/intercept/EngineInterceptor.kt - Engine Interceptor → Memory Cache Service: checks cache
coil-core/src/commonMain/kotlin/coil3/intercept/EngineInterceptor.kt - Memory Cache Service → Memory Cache: reads and writes
coil-core/src/commonMain/kotlin/coil3/memory/MemoryCacheService.kt - Engine Interceptor → Fetchers: fetches data
coil-core/src/commonMain/kotlin/coil3/intercept/EngineInterceptor.kt - Engine Interceptor → Decoders: decodes data
coil-core/src/commonMain/kotlin/coil3/intercept/EngineInterceptor.kt - Engine Interceptor → Transformations: applies transforms
coil-core/src/commonMain/kotlin/coil3/intercept/EngineInterceptor.kt - Engine Interceptor → Image Result: returns image
coil-core/src/commonMain/kotlin/coil3/intercept/EngineInterceptor.kt - ImageLoader → Disk Cache: configures cache
coil-core/src/commonMain/kotlin/coil3/ImageLoader.kt - Service Loader → Fetchers: registers factories
coil-core/src/commonMain/kotlin/coil3/util/ServiceLoaderComponentRegistry.kt - Service Loader → Decoders: registers factories
coil-core/src/commonMain/kotlin/coil3/util/ServiceLoaderComponentRegistry.kt - Network Fetcher → Network Clients: uses client
coil-network-core/src/commonMain/kotlin/coil3/network/NetworkFetcher.kt - Component Registry → Network Fetcher: can provide
- Component Registry → GIF Decoder: can provide
- Component Registry → SVG Decoder: can provide
- Component Registry → Video Decoder: can provide