# Iconoir — card for AI agents

Open-source library of 1,383 outline SVG icons, 288 of them also in a solid variant (1,671 SVGs in all, as reported in the README), with React, Vue, Flutter and CSS packages.

Category: Icons · maker Luca Burgio · checked 2026-11-09 · style: outline, minimal

## Price
- Price: Free
- Free tier: Fully free.

## License
MIT — https://raw.githubusercontent.com/iconoir-icons/iconoir/main/LICENSE

- commercial: **yes** (Commercial use OK)
  > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software
  (https://raw.githubusercontent.com/iconoir-icons/iconoir/main/LICENSE)
- attribution: **no** (No credit needed)
  > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
  (https://raw.githubusercontent.com/iconoir-icons/iconoir/main/LICENSE)
- in app: **yes** (Can ship inside your app)
  > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software
  (https://raw.githubusercontent.com/iconoir-icons/iconoir/main/LICENSE)
- redistribute: **yes** (Can pass the files on to your own users)
  > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software
  (https://raw.githubusercontent.com/iconoir-icons/iconoir/main/LICENSE)

## Rules to follow
- Keep the license notice when you copy the source files

## Can an AI agent use it by itself?
**Yes** · package: Agent installs a package or loads it from a CDN

## How an agent gets files
- npm install iconoir (raw SVG) or iconoir-react; or copy SVG from iconoir.com. No account. (sign-in: none)
- Formats: svg, jsx
- Not allowed: MIT notice in redistributed source

## How to connect
- Package (npm/PyPI)
- npm: `npm install iconoir`
- Repository: https://github.com/iconoir-icons/iconoir
- Website: https://iconoir.com

## Numbers (AgentGid data)
- Gid Score: 41
- GitHub stars: 4,648
- Downloads last week: 47,035

## Lines to paste into your prompt or AGENTS.md

```
- Iconoir (Icons). Open-source library of 1,383 outline SVG icons, 288 of them also in a solid variant (1,671 SVGs in all, as reported in the README), with React, Vue, Flutter and CSS packages. Price: free; commercial use OK; no credit needed. Style: outline, minimal.
  Connect: npm iconoir.
  Get files: npm install iconoir (raw SVG) or iconoir-react; or copy SVG from iconoir.com. No account (svg, jsx).
  Not allowed: MIT notice in redistributed source
  Rule: Keep the license notice when you copy the source files
  License: https://raw.githubusercontent.com/iconoir-icons/iconoir/main/LICENSE (checked 2026-11-09; details: https://agentgid.com/assets/iconoir/)
```

## Links
- AgentGid page: https://agentgid.com/assets/iconoir/
- Is it free for commercial use? https://agentgid.com/assets/iconoir/commercial-use/
- Source: https://iconoir.com
- Source: https://raw.githubusercontent.com/iconoir-icons/iconoir/main/LICENSE


## Iconoir: free thin-line icons with solid twins

Iconoir is a free set of simple line icons, such as a house, a bell or a heart, drawn in one thin matching style. You or your AI assistant add them to a website, web app or mobile app, and some icons also come in a filled version. They are free for paid products, with no sign-up and no paid tier.

### Where to use it
- Icons in a React app: Each icon is a ready piece you put in a screen, such as a bell next to Notifications. Only the icons you use end up in your app.
- One look for every icon: Set the color, size and line thickness once for a whole section or app, instead of repeating them on every icon.
- Liked and saved states: Show an empty heart, star or bookmark, and its filled twin once the user taps it. 288 icons have such a filled version.
- Icons on a plain website: A page without a framework gets icons from one stylesheet and a short tag per icon, like a hand brake or an arrow.
- Icons inside server-made pages: Paste the icon file straight into a page or email made on your server, with your own size and line width. (idea, not from the official pages)
- Matching icons in mobile apps: Use the same icons in a React Native, Flutter or iPhone app as on your website, so both look alike.

### How to start
- Add the React package (there are also packages for Vue, React Native, Flutter, plain SVG files and a CSS stylesheet).

```
npm i iconoir-react
```

- Import an icon by its name in PascalCase and place it; color, width, height and strokeWidth are props (defaults currentColor, 1.5em, 1.5em, 1.5).

```
import { Iconoir } from 'iconoir-react';
import React from 'react';

function App() {
  return <Iconoir />;
}

export default App;
```

- Without a framework, load the stylesheet and use the class iconoir- plus the icon name.

```
<i class="iconoir-hand-brake"></i>
```


### License
MIT license: free for personal and paid products, with no credit needed in your app. If you pass on the icon library itself, keep its short license notice with it.

### Good to know
- There are 1,383 icons; 288 of them also have a filled version, all on the same grid with the same thin line.
- There is no ready package for Svelte or Angular; there you use the icon files or the stylesheet.
- Some brand icons such as GitHub or YouTube are included. They show other companies' logos, so use them only to point to those services.
- Other websites use the Iconoir name without being part of the project; download only from the official places.
- Icons take the text color around them, so they change with your theme without extra work.

Checked 2026-11-09 against: https://iconoir.com, https://iconoir.com/docs/introduction, https://iconoir.com/docs/faq, https://iconoir.com/docs/packages/iconoir-react, https://iconoir.com/docs/packages/css, https://iconoir.com/docs/naming-convention, https://github.com/iconoir-icons/iconoir/blob/main/README.md, https://github.com/iconoir-icons/iconoir/blob/main/LICENSE, https://registry.npmjs.org/iconoir/latest, https://registry.npmjs.org/iconoir-react/latest, https://registry.npmjs.org/iconoir-react/7.12.2

### Mistakes to avoid
- Don't: <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/iconoir-icons/iconoir@main/css/iconoir.css" /> in production → Do: Pin a release: https://cdn.jsdelivr.net/npm/iconoir@7.12.2/css/iconoir.css, or bundle the file from the npm package (The docs link points at the main branch, which changes with every update, so icons can change or disappear without notice.)
- Don't: Loading css/iconoir.css for a handful of icons → Do: Use iconoir-react or @iconoir/vue, or paste the few SVG files you need (In 7.12.2 the all-in-one stylesheet is about 2.9 MB with every icon inside (our demo check); the React and Vue packages only bundle the icons you import.)
- Don't: import { HeartFilled } from 'iconoir-react' or the class iconoir-heart-filled → Do: HeartSolid / iconoir-heart-solid, and only for the 288 icons that have a solid version (Filled versions are named with Solid / -solid.)
- Don't: npm i iconoir-react-native alone → Do: npm i iconoir-react-native react-native-svg (The React Native package draws through react-native-svg, which the docs install alongside it.)
- Don't: import { AirplaneHelix45Deg } from 'iconoir-react' → Do: import { AirplaneHelix45deg } from 'iconoir-react' (Component names are the PascalCase form of the file name, so letters after digits keep their case.)

### Questions
- Can I use Iconoir in a paid app or a client site? Yes. It is MIT licensed and the project says you can use it in personal and commercial projects, apps, websites and products.
- Do I have to credit Iconoir? No credit is needed to use the icons. Only when you pass on the library itself do you keep the MIT notice.
- Are there filled icons? Yes, 288 icons have a solid version; the file names end in -solid and the React components in Solid, like HeartSolid.
- Which frameworks are supported? React, React Native, Vue, Solid and Flutter have packages, plus a CSS stylesheet, plain SVG files, a Figma file and a set built into Framer. Svelte and Angular have no official package.
- Can I get a single icon as a PNG? Yes. On iconoir.com you can copy any icon as SVG or download it as SVG or PNG, after setting size, line width and color.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
