Butterdrop

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}
FormatWhat you get
.svgSVG: Still vector of the final frame, any size.
.pngPNG: Still image of the final frame, up to 1200 px.
.gifGIF: Looping animation that plays everywhere, including email.
.webpWebP: Looping animation, much smaller than GIF.
.apngAPNG: Looping animation with full colour, plays in all modern browsers.
.jsonLottie JSON: Lottie animation for lottie-web, iOS, Android and Flutter.
.lottiedotLottie: Compressed Lottie (.lottie), the smallest animated file.
ParameterValues
themelime, peach, lilac, pool, honey, rose, flare, graphite, ink
cCustom 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.
motionbutter (default) or bouncy
sizePixels: animated 64–600 (default 400), still 64–1200 (default 800)
fps12, 15, 20, 24 (default) or 30
download1 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.