1219 icons in five styles and three corner radii, drawn on a 24 pixel grid with a 2 pixel stroke. Open source under the MIT license.
The packages are in beta. Icon names are final, the API may still change until 5.0.0.
| Package | |
|---|---|
@coolicons/react |
React components |
@coolicons/vue |
Vue 3 components |
@coolicons/svg |
SVG files and a manifest for everything else |
npm install @coolicons/reactimport { House } from "@coolicons/react";
export function Home() {
return <House size={20} />;
}npm install @coolicons/vue<script setup>
import { House } from "@coolicons/vue";
</script>
<template>
<House :size="20" />
</template>npm install @coolicons/svgEvery icon is a file at @coolicons/svg/<style>/<radius>/<name>.svg, for example @coolicons/svg/line/regular/house.svg. manifest.json lists each icon with its category and a fingerprint per file. Each release on GitHub also has all files as a zip.
| Style | |
|---|---|
line |
Strokes |
duocolor |
Strokes with a lighter second stroke |
duotone |
Strokes over a light tone |
fill |
Solid shapes |
bulk |
Solid shapes over a light tone |
Each style comes with sharp, regular and round corners. The package root is Line with Regular corners. Every other combination has its own entry, and only the icons you import end up in your bundle:
import { House } from "@coolicons/react";
import { Folder } from "@coolicons/react/fill";
import { Bell } from "@coolicons/react/bulk/round";Icons use currentColor and take the text color around them.
| Prop | Default | |
|---|---|---|
size |
24 |
Width and height in pixels or any CSS length |
strokeWidth |
2 |
Stroke width of Line, Duocolor and Duotone. Fill and Bulk have no strokes |
title |
Adds a <title> and role="img". Without a title the icon is hidden from screen readers |
All other attributes go to the <svg> element.
Names are lowercase English words joined by hyphens, like file-plus-corner. Components use the same words in PascalCase, like FilePlusCorner, and are also exported with an Icon suffix, like FilePlusCornerIcon. Use the suffix where a name clashes with the browser or your framework, like Image, Link or Map.
Some icons have a second name, like reply for arrow-u-turn-up-left. Both point to the same component.
When the icon comes from data, like in a CMS or an icon picker, CooliconsIcon renders it by its name. It loads all icons of one style and radius on first use, about 60 KB gzipped for Line and 230 KB for Bulk.
import { CooliconsIcon, icons } from "@coolicons/react/dynamic";
<CooliconsIcon name="house" variant="fill" radius="round" />icons lists every name with its category, preload(variant, radius) loads a style ahead of time.
All packages share one version. From 5.0.0 on, a major version removes or renames icons, a minor version adds icons and a patch redraws icons or changes categories. A renamed icon keeps its old name until the next major version.
The brand icons show logos of other companies. The trademarks belong to their owners. The MIT license covers the drawing, not the trademark. If you use a logo, follow the brand guidelines of its owner.
MIT © Kryston Schwarze