The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Iconoteka listing page.
A universal, open-source library of precisely designed pictograms.
Website · Figma Plugin · License
| 1,300 icons | from rapid prototyping to real-world wayfinding systems |
| 7 weights | Thin, Ultralight, Light, Regular, Medium, Semibold, Bold |
| 2 styles | stroke and fill |
| 14,970 shapes | complete coverage for almost any use case |
| 23 categories | Arrows, Interface, Hardware, Nature, Transportation, … |
Take the icons you need — there's no need to install or clone the whole library.
In Figma — install the plugin, search, drag the icon onto the canvas.
One icon at a time — every icon is a standalone SVG on the CDN:
The path is Icons/{Category}/{name}-{weight}-{style}.svg, where weight is one
of t u l r m s b (thin → bold) and style is s for stroke or f
for fill. Categories with spaces need URL-encoding: Files%20%26%20Data.
Inline in your markup — both styles are outlined paths, so an icon is a
single <path> with no stroke attributes. Every SVG ships with
fill="currentColor", so it inherits the surrounding text colour:
Swap the weight or style by changing one letter in the filename — the geometry is designed to stay optically balanced across all seven weights.
Icons as components, generated from the same SVGs:
weight takes any of the seven, variant is stroke or fill, and anything
else is spread onto the <svg>. Each icon is its own module, so bundlers drop
what you don't import.
icons.json carries every icon and variant in one file — useful for bundling
the set into a design system, generating components, or pulling icons at build
time.
Or fetch it from the CDN:
Pin the tag rather than @main — jsDelivr caches branch URLs for up to 7 days.
The npm package contains icons.json only; the raw SVGs stay in the repo.
The first segment of name is the icon's identity; the rest are search-only
aliases, so match on the identity rather than the full string. Weights are
keyed thin, ultralight, light, regular, medium, semibold, bold,
each holding a stroke and/or fill path.
A curated selection carries "popular": true, listed by identity in
meta.popular. Popular is a flag, not a category — no icon is stored twice.
24-point grid — every icon is built on a 24px grid, so straight lines stay crisp at 24, 48, 96px and beyond, and the set sits comfortably alongside other popular libraries.
Advanced optics — deliberate overshoots, density-based weight modularity and optical stroke compensation throughout.
Bracketing system — preserves structural integrity across all seven weights. Unlike stroke-based sets that simply scale outlines, legibility and visual balance hold at both extremes.
System architecture — a structured metaphor hierarchy, a 5° geometric angle rule, tiered corner rounding and modular components keep the library consistent at production scale.
Universality — geometric construction and high visual clarity keep the icons legible across products and industries that demand contrast and structural consistency.
Iconoteka is a free, open-source library created and maintained by one person. Support its future development through a monthly Patreon subscription or a one-time Ko-fi donation.
MIT — see LICENSE. Free for personal and commercial use, including in closed-source products. No permission needed, no fee. Credit isn't required, though it's always appreciated.
Built by Oleg Turbaba, Brand Design Director at Clay Global — a multidisciplinary designer working at the intersection of brand identity, digital products and visual experiences.
For enquiries, collaborations, interviews or sponsorships: olegturbaba@gmail.com
Instagram · LinkedIn · Behance
Sharing your work? Mention @iconoteka on Instagram, LinkedIn or X.