Formats, API and embed
Every icon is available at a stable URL in seven file formats, any built-in or custom theme, and two motion styles. No key needed.
How do I download an icon by URL?
GET https://butterdrop.ta9in.com/api/v1/icons/{icon}.{format}?theme={theme}
| Format | What you get |
|---|---|
.svg | SVG: Still vector of the final frame, any size. |
.png | PNG: Still image of the final frame, up to 1200 px. |
.gif | GIF: Looping animation that plays everywhere, including email. |
.webp | WebP: Looping animation, much smaller than GIF. |
.apng | APNG: Looping animation with full colour, plays in all modern browsers. |
.json | Lottie JSON: Lottie animation for lottie-web, iOS, Android and Flutter. |
.lottie | dotLottie: Compressed Lottie (.lottie), the smallest animated file. |
| Parameter | Values |
|---|---|
theme | lime, peach, lilac, pool, honey, rose, flare, graphite, ink |
c | Custom theme: base64url JSON with bg top hi mid deep shade text (hex), optional sw (line weight 0.6–2.5), dark, hatch. The playground builds it for you. |
motion | butter (default) or bouncy |
size | Pixels: animated 64–600 (default 400), still 64–1200 (default 800) |
fps | 12, 15, 20, 24 (default) or 30 |
download | 1 to save the file instead of showing it |
Example: /api/v1/icons/ai-network.webp?theme=ink. The full list of icons is at /api/v1/catalog (JSON).
How do I embed the live animation?
<script src="https://butterdrop.ta9in.com/embed.js" defer></script> <butterdrop-icon icon="ai-network" theme="lime" style="width:320px"></butterdrop-icon>
Attributes: icon, theme, motion (butter or bouncy), mode (loop, solo for a single drop on a fixed plinth, or hold for a still). It animates only while on screen and shows the still frame when the visitor prefers reduced motion.
What about video and Rive?
Each icon page records WebM or MP4 in your browser (MP4 where the browser supports recording it). Rive export is planned: Rive files are produced with Rive's own markup and CLI, and frame-by-frame icons need a different build. Use Lottie meanwhile.
License
Free to use in personal and commercial projects during the beta, with no attribution required. Please do not resell or redistribute the icons as an icon pack of your own.