coil-resvg
1.0.0indexedSVG decoder for Coil, rendering vector images to pixel-perfect bitmaps via resvg Rust FFI, with system font support, consistent rendering and no browser dependency.
33
Stars
—
Used by
dependents
—
Health
/ 100
coil-resvg
A Kotlin Multiplatform SVG decoder for Coil 3, powered by resvg (Rust).
Renders SVG images to pixel-perfect bitmaps using the resvg engine via Rust FFI, with text/font support on every platform.
Screenshot Comparison
| Android | iOS |
|---|---|
 |  |
SVG Examples
Supported Platforms
| Platform | Status |
|---|---|
| Android | ✅ |
Note: The JS / Wasm (Browser) targets currently use the browser's native SVG rendering pipeline, not resvg FFI.
Installation
Add the dependency to your build.gradle.kts:
// build.gradle.kts
dependencies {
implementation("com.hashsequence:coil-resvg:1.1.2")
}
For Kotlin Multiplatform projects, add it to commonMain:
kotlin {
sourceSets {
commonMain.dependencies {
implementation("com.hashsequence:coil-resvg:1.1.2")
}
}
}
Usage
Register ResvgDecoder as a component in your Coil ImageLoader:
setSingletonImageLoaderFactory { context ->
ImageLoader.Builder(context)
.components {
add(ResvgDecoder.Factory())
}
.build()
}
Then load SVG images as usual with Coil:
AsyncImage(
model = "https://example.com/image.svg",
contentDescription = null,
)
That's it — SVG files will be automatically detected and rendered by resvg.
Rendered bitmap disk cache
ResvgDecoder.Factory() caches rendered bitmaps as PNGs in Coil's disk cache by default on Android,
iOS, and JVM. When the SVG content and rendering options match a cached entry, later requests decode
the PNG instead of parsing and rendering the SVG again, speeding up repeated loads.
These entries share Coil's cache size limit and automatic eviction, and respect each request's
diskCachePolicy.
To disable it, use ResvgDecoder.Factory(diskCacheEnabled = false).
Why resvg?
- Pixel-perfect rendering — resvg is one of the most accurate SVG renderers available, passing the SVG static rendering test suite.
- Text & font support — Loads system fonts on each platform (Android/iOS/Desktop).
- No browser dependency — Unlike AndroidSVG or WebView-based approaches, resvg is a standalone renderer with zero platform UI dependencies.
- Consistent cross-platform output — The same Rust engine runs on all platforms, producing identical rendering results everywhere.
Fonts: fallback behavior & performance
- Because resvg is platform-independent, its font behavior may be less polished than each platform's native text stack (e.g., weaker fallback selection, and emoji may not render correctly on iOS 26).
- SVGs with text:
- First render may be slower because it scans the system font database to find usable fonts.
- Subsequent renders hit a cache and won't rescan system fonts.
- SVGs without text: rendering is not affected by the font scan on first render.
How It Works
The library uses resvg + tiny-skia compiled as a native Rust library, bridged to Kotlin via UniFFI and Gobley. The SVG is parsed by usvg, rendered to RGBA pixels by resvg, and then converted to a platform-native bitmap (e.g., , , ).
License
Copyright 2026 HashSequence
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance the License.
You may obtain a copy of the License at
https:
Unless applicable law agreed to writing, software
distributed under the License distributed an BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express implied.
See the License the specific language governing permissions
limitations under the License.
