# coil-kt/coil architecture

> Architecture diagram of the GitHub repository coil-kt/coil, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/coil-kt/coil
- Repository: https://github.com/coil-kt/coil

## Overview

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: [`coil-core/src/commonMain/kotlin/coil3/intercept/EngineInterceptor.kt`](https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/intercept/EngineInterceptor.kt) (Engine Interceptor), [`coil-core/src/commonMain/kotlin/coil3/ComponentRegistry.kt`](https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/ComponentRegistry.kt) (Component Registry), [`coil-core/src/commonMain/kotlin/coil3/ImageLoader.kt`](https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/ImageLoader.kt) (ImageLoader), [`coil-core/src/commonMain/kotlin/coil3/util/ServiceLoaderComponentRegistry.kt`](https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/util/ServiceLoaderComponentRegistry.kt) (Service Loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Compose UI"]
  node_asyncimage["AsyncImage<br/>[AsyncImage.kt]"]
  node_painter["AsyncImagePainter"]
end

subgraph group_pipeline["Loading Pipeline"]
  node_loader["ImageLoader<br/>[ImageLoader.kt]"]
  node_request["ImageRequest<br/>[ImageRequest.kt]"]
  node_requestservice["Request Service<br/>[RequestService.kt]"]
  node_engine["Engine Interceptor"]
  node_registry["Component Registry"]
  node_fetchers["Fetchers<br/>[Fetcher.kt]"]
  node_decoders["Decoders<br/>[Decoder.kt]"]
  node_transformations["Transformations<br/>[Transformation.kt]"]
  node_image["Image Result<br/>[Image.kt]"]
  node_service_loader["Service Loader"]
end

subgraph group_storage["Caching"]
  node_memoryservice["Memory Cache Service"]
  node_memorycache[("Memory Cache<br/>[MemoryCache.kt]")]
  node_diskcache[("Disk Cache<br/>[DiskCache.kt]")]
end

subgraph group_integrations["Platform Integrations"]
  node_networkfetcher["Network Fetcher<br/>[NetworkFetcher.kt]"]
  node_networkclient["Network Clients<br/>[NetworkClient.kt]"]
  node_gif["GIF Decoder<br/>[GifDecoder.kt]"]
  node_svg["SVG Decoder"]
  node_video["Video Decoder"]
end

node_user(("App developer"))

node_user -->|"requests image"| node_asyncimage
node_asyncimage -.->|"renders with"| node_painter
node_painter -->|"executes request"| node_loader
node_loader -->|"handles requests"| node_requestservice
node_loader -.->|"runs pipeline"| node_engine
node_engine -->|"selects components"| node_registry
node_engine -->|"checks cache"| node_memoryservice
node_memoryservice -->|"reads and writes"| node_memorycache
node_engine -->|"fetches data"| node_fetchers
node_engine -->|"decodes data"| node_decoders
node_engine -->|"applies transforms"| node_transformations
node_engine -->|"returns image"| node_image
node_loader -->|"configures cache"| node_diskcache
node_service_loader -->|"registers factories"| node_fetchers
node_service_loader -->|"registers factories"| node_decoders
node_networkfetcher -.->|"uses client"| node_networkclient
node_registry -.->|"can provide"| node_networkfetcher
node_registry -.->|"can provide"| node_gif
node_registry -.->|"can provide"| node_svg
node_registry -.->|"can provide"| node_video

click node_asyncimage "https://github.com/coil-kt/coil/blob/main/coil-compose-core/src/commonMain/kotlin/coil3/compose/AsyncImage.kt"
click node_painter "https://github.com/coil-kt/coil/blob/main/coil-compose-core/src/commonMain/kotlin/coil3/compose/AsyncImagePainter.kt"
click node_loader "https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/ImageLoader.kt"
click node_request "https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/request/ImageRequest.kt"
click node_requestservice "https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/request/RequestService.kt"
click node_engine "https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/intercept/EngineInterceptor.kt"
click node_registry "https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/ComponentRegistry.kt"
click node_fetchers "https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/fetch/Fetcher.kt"
click node_networkfetcher "https://github.com/coil-kt/coil/blob/main/coil-network-core/src/commonMain/kotlin/coil3/network/NetworkFetcher.kt"
click node_networkclient "https://github.com/coil-kt/coil/blob/main/coil-network-core/src/commonMain/kotlin/coil3/network/NetworkClient.kt"
click node_decoders "https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/decode/Decoder.kt"
click node_transformations "https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/transform/Transformation.kt"
click node_image "https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/Image.kt"
click node_memoryservice "https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/memory/MemoryCacheService.kt"
click node_memorycache "https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/memory/MemoryCache.kt"
click node_diskcache "https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/disk/DiskCache.kt"
click node_service_loader "https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/util/ServiceLoaderComponentRegistry.kt"
click node_gif "https://github.com/coil-kt/coil/blob/main/coil-gif/src/main/java/coil3/gif/GifDecoder.kt"
click node_svg "https://github.com/coil-kt/coil/blob/main/coil-svg/src/commonMain/kotlin/coil3/svg/internal/SvgDecoderServiceLoaderTarget.kt"
click node_video "https://github.com/coil-kt/coil/blob/main/coil-video/src/main/java/coil3/video/VideoFrameDecoder.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_asyncimage,node_painter toneBlue
class node_loader,node_request,node_requestservice,node_engine,node_registry,node_fetchers,node_decoders,node_transformations,node_image,node_service_loader toneAmber
class node_memoryservice,node_memorycache,node_diskcache toneMint
class node_networkfetcher,node_networkclient,node_gif,node_svg,node_video toneRose
class node_user toneIndigo
```

## Components

### Compose UI

- [AsyncImage](https://github.com/coil-kt/coil/blob/main/coil-compose-core/src/commonMain/kotlin/coil3/compose/AsyncImage.kt): `coil-compose-core/src/commonMain/kotlin/coil3/compose/AsyncImage.kt`
- [AsyncImagePainter](https://github.com/coil-kt/coil/blob/main/coil-compose-core/src/commonMain/kotlin/coil3/compose/AsyncImagePainter.kt): `coil-compose-core/src/commonMain/kotlin/coil3/compose/AsyncImagePainter.kt`

### Loading Pipeline

- [ImageLoader](https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/ImageLoader.kt): `coil-core/src/commonMain/kotlin/coil3/ImageLoader.kt`
- [ImageRequest](https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/request/ImageRequest.kt): `coil-core/src/commonMain/kotlin/coil3/request/ImageRequest.kt`
- [Request Service](https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/request/RequestService.kt): `coil-core/src/commonMain/kotlin/coil3/request/RequestService.kt`
- [Engine Interceptor](https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/intercept/EngineInterceptor.kt): `coil-core/src/commonMain/kotlin/coil3/intercept/EngineInterceptor.kt`
- [Component Registry](https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/ComponentRegistry.kt): `coil-core/src/commonMain/kotlin/coil3/ComponentRegistry.kt`
- [Fetchers](https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/fetch/Fetcher.kt): `coil-core/src/commonMain/kotlin/coil3/fetch/Fetcher.kt`
- [Decoders](https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/decode/Decoder.kt): `coil-core/src/commonMain/kotlin/coil3/decode/Decoder.kt`
- [Transformations](https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/transform/Transformation.kt): `coil-core/src/commonMain/kotlin/coil3/transform/Transformation.kt`
- [Image Result](https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/Image.kt): `coil-core/src/commonMain/kotlin/coil3/Image.kt`
- [Service Loader](https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/util/ServiceLoaderComponentRegistry.kt): `coil-core/src/commonMain/kotlin/coil3/util/ServiceLoaderComponentRegistry.kt`

### Caching

- [Memory Cache Service](https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/memory/MemoryCacheService.kt): `coil-core/src/commonMain/kotlin/coil3/memory/MemoryCacheService.kt`
- [Memory Cache](https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/memory/MemoryCache.kt): `coil-core/src/commonMain/kotlin/coil3/memory/MemoryCache.kt`
- [Disk Cache](https://github.com/coil-kt/coil/blob/main/coil-core/src/commonMain/kotlin/coil3/disk/DiskCache.kt): `coil-core/src/commonMain/kotlin/coil3/disk/DiskCache.kt`

### Platform Integrations

- [Network Fetcher](https://github.com/coil-kt/coil/blob/main/coil-network-core/src/commonMain/kotlin/coil3/network/NetworkFetcher.kt): `coil-network-core/src/commonMain/kotlin/coil3/network/NetworkFetcher.kt`
- [Network Clients](https://github.com/coil-kt/coil/blob/main/coil-network-core/src/commonMain/kotlin/coil3/network/NetworkClient.kt): `coil-network-core/src/commonMain/kotlin/coil3/network/NetworkClient.kt`
- [GIF Decoder](https://github.com/coil-kt/coil/blob/main/coil-gif/src/main/java/coil3/gif/GifDecoder.kt): `coil-gif/src/main/java/coil3/gif/GifDecoder.kt`
- [SVG Decoder](https://github.com/coil-kt/coil/blob/main/coil-svg/src/commonMain/kotlin/coil3/svg/internal/SvgDecoderServiceLoaderTarget.kt): `coil-svg/src/commonMain/kotlin/coil3/svg/internal/SvgDecoderServiceLoaderTarget.kt`
- [Video Decoder](https://github.com/coil-kt/coil/blob/main/coil-video/src/main/java/coil3/video/VideoFrameDecoder.kt): `coil-video/src/main/java/coil3/video/VideoFrameDecoder.kt`

### Other components

- **App developer**

## Connections

- App developer → AsyncImage: requests image (evidence: `README.md`)
- AsyncImage → AsyncImagePainter: renders with
- AsyncImagePainter → ImageLoader: executes request (evidence: `coil-compose-core/src/commonMain/kotlin/coil3/compose/LocalAsyncImagePreviewHandler.kt`)
- ImageLoader → Request Service: handles requests (evidence: `coil-core/src/commonMain/kotlin/coil3/request/RequestService.kt`)
- ImageLoader → Engine Interceptor: runs pipeline (evidence: `coil-core/src/commonMain/kotlin/coil3/intercept/EngineInterceptor.kt`)
- Engine Interceptor → Component Registry: selects components (evidence: `coil-core/src/commonMain/kotlin/coil3/intercept/EngineInterceptor.kt`)
- Engine Interceptor → Memory Cache Service: checks cache (evidence: `coil-core/src/commonMain/kotlin/coil3/intercept/EngineInterceptor.kt`)
- Memory Cache Service → Memory Cache: reads and writes (evidence: `coil-core/src/commonMain/kotlin/coil3/memory/MemoryCacheService.kt`)
- Engine Interceptor → Fetchers: fetches data (evidence: `coil-core/src/commonMain/kotlin/coil3/intercept/EngineInterceptor.kt`)
- Engine Interceptor → Decoders: decodes data (evidence: `coil-core/src/commonMain/kotlin/coil3/intercept/EngineInterceptor.kt`)
- Engine Interceptor → Transformations: applies transforms (evidence: `coil-core/src/commonMain/kotlin/coil3/intercept/EngineInterceptor.kt`)
- Engine Interceptor → Image Result: returns image (evidence: `coil-core/src/commonMain/kotlin/coil3/intercept/EngineInterceptor.kt`)
- ImageLoader → Disk Cache: configures cache (evidence: `coil-core/src/commonMain/kotlin/coil3/ImageLoader.kt`)
- Service Loader → Fetchers: registers factories (evidence: `coil-core/src/commonMain/kotlin/coil3/util/ServiceLoaderComponentRegistry.kt`)
- Service Loader → Decoders: registers factories (evidence: `coil-core/src/commonMain/kotlin/coil3/util/ServiceLoaderComponentRegistry.kt`)
- Network Fetcher → Network Clients: uses client (evidence: `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
