{
 "slug": "iconoir",
 "name": "Iconoir",
 "author": "Luca Burgio",
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "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": {
  "slug": "icons",
  "name": "Icons"
 },
 "tags": [
  "Code library",
  "Open source"
 ],
 "styles": [
  "outline",
  "minimal"
 ],
 "logo_url": "https://agentgid.com/media/avatars/iconoir-icons.png",
 "logo_letter": "I",
 "links": {
  "repo": "https://github.com/iconoir-icons/iconoir",
  "website": "https://iconoir.com",
  "api_docs": null
 },
 "preview": {
  "kind": "image_grid",
  "src": "https://agentgid.com/assets/iconoir/demo.jpg",
  "alt": "A sidebar with seven sections, eight icons next to their solid twins, six icons at line widths 1, 1.5 and 2.25, and five icons in different colors.",
  "caption": "Made by AgentGid with iconoir 7.12.2 (npm). Iconoir is under the MIT license, which allows showing and passing on the icons; no brand icons are used."
 },
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Free",
   "status": "yes",
   "sub": "No paid plan",
   "quote": null,
   "note": "Fully free.",
   "source": {
    "label": "iconoir.com",
    "url": "https://iconoir.com"
   },
   "n": 1
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "Yes",
   "status": "yes",
   "sub": "MIT",
   "quote": "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",
   "note": "MIT; free for personal and commercial projects, apps, websites and products.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/iconoir-icons/iconoir/main/LICENSE"
   },
   "n": 2
  },
  {
   "key": "credit",
   "label": "Credit the author",
   "value": "Not needed",
   "status": "yes",
   "sub": "Keep the notice in code copies",
   "quote": "The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.",
   "note": "No credit on screen. Keep the license notice inside the code you ship.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/iconoir-icons/iconoir/main/LICENSE"
   },
   "n": 3
  },
  {
   "key": "agent_access",
   "label": "Agent access",
   "value": "npm package",
   "status": "info",
   "sub": "Installs without a key",
   "quote": null,
   "note": "An agent can install it by itself with npm install iconoir. No key or account is needed.",
   "source": {
    "label": "github.com/iconoir-icons/iconoir",
    "url": "https://github.com/iconoir-icons/iconoir"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "MIT",
  "url": "https://raw.githubusercontent.com/iconoir-icons/iconoir/main/LICENSE",
  "summary": "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.",
  "pages_read": 1,
  "rules": [
   "Keep the license notice when you copy the source files"
  ],
  "rows": [
   {
    "label": "Commercial use",
    "value": "Yes",
    "status": "yes",
    "quote": "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",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/iconoir-icons/iconoir/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Credit",
    "value": "Not needed",
    "status": "yes",
    "quote": "The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/iconoir-icons/iconoir/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Inside your app or game",
    "value": "Can ship inside your app",
    "status": "yes",
    "quote": "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",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/iconoir-icons/iconoir/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Pass the files on to your users",
    "value": "Allowed",
    "status": "yes",
    "quote": "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",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/iconoir-icons/iconoir/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "AI training",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   },
   {
    "label": "Bots and bulk downloads",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   }
  ],
  "checked_at": "2026-11-09",
  "commercial_use_page": "https://agentgid.com/assets/iconoir/commercial-use/"
 },
 "overview": {
  "heading": "Iconoir: free thin-line icons with solid twins",
  "body": "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."
 },
 "uses": [
  {
   "title": "Icons in a React app",
   "text": "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.",
   "idea": false,
   "image": null
  },
  {
   "title": "One look for every icon",
   "text": "Set the color, size and line thickness once for a whole section or app, instead of repeating them on every icon.",
   "idea": false,
   "image": null
  },
  {
   "title": "Liked and saved states",
   "text": "Show an empty heart, star or bookmark, and its filled twin once the user taps it. 288 icons have such a filled version.",
   "idea": false,
   "image": null
  },
  {
   "title": "Icons on a plain website",
   "text": "A page without a framework gets icons from one stylesheet and a short tag per icon, like a hand brake or an arrow.",
   "idea": false,
   "image": null
  },
  {
   "title": "Icons inside server-made pages",
   "text": "Paste the icon file straight into a page or email made on your server, with your own size and line width.",
   "idea": true,
   "image": null
  },
  {
   "title": "Matching icons in mobile apps",
   "text": "Use the same icons in a React Native, Flutter or iPhone app as on your website, so both look alike.",
   "idea": false,
   "image": null
  }
 ],
 "start": {
  "prompt": "Add Iconoir icons with iconoir-react 7.12.2: Home, Mail, Calendar and Settings in the sidebar, Heart that switches to HeartSolid when liked, set defaults with IconoirProvider, and give icon-only buttons an aria-label.",
  "install": "npm i iconoir-react",
  "install_note": "Add the React package (there are also packages for Vue, React Native, Flutter, plain SVG files and a CSS stylesheet).",
  "code": [
   {
    "tab": "Step 1",
    "intro": "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).",
    "source": "import { Iconoir } from 'iconoir-react';\nimport React from 'react';\n\nfunction App() {\n  return <Iconoir />;\n}\n\nexport default App;"
   },
   {
    "tab": "Step 2",
    "intro": "Without a framework, load the stylesheet and use the class iconoir- plus the icon name.",
    "source": "<i class=\"iconoir-hand-brake\"></i>"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "<link rel=\"stylesheet\" href=\"https://cdn.jsdelivr.net/gh/iconoir-icons/iconoir@main/css/iconoir.css\" /> in production",
   "fix": "Pin a release: https://cdn.jsdelivr.net/npm/iconoir@7.12.2/css/iconoir.css, or bundle the file from the npm package",
   "why": "The docs link points at the main branch, which changes with every update, so icons can change or disappear without notice.",
   "dont_code": true,
   "fix_code": false
  },
  {
   "dont": "Loading css/iconoir.css for a handful of icons",
   "fix": "Use iconoir-react or @iconoir/vue, or paste the few SVG files you need",
   "why": "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.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "import { HeartFilled } from 'iconoir-react' or the class iconoir-heart-filled",
   "fix": "HeartSolid / iconoir-heart-solid, and only for the 288 icons that have a solid version",
   "why": "Filled versions are named with Solid / -solid.",
   "dont_code": true,
   "fix_code": false
  },
  {
   "dont": "npm i iconoir-react-native alone",
   "fix": "npm i iconoir-react-native react-native-svg",
   "why": "The React Native package draws through react-native-svg, which the docs install alongside it.",
   "dont_code": true,
   "fix_code": true
  },
  {
   "dont": "import { AirplaneHelix45Deg } from 'iconoir-react'",
   "fix": "import { AirplaneHelix45deg } from 'iconoir-react'",
   "why": "Component names are the PascalCase form of the file name, so letters after digits keep their case.",
   "dont_code": true,
   "fix_code": true
  }
 ],
 "agent": {
  "self_serve": true,
  "self_serve_text": "Agent installs a package or loads it from a CDN",
  "install": "npm install iconoir",
  "repo": "https://github.com/iconoir-icons/iconoir",
  "api_docs": null,
  "api_account": "Not needed. Everything runs on your side.",
  "get_files": "npm install iconoir (raw SVG) or iconoir-react; or copy SVG from iconoir.com. No account.",
  "formats": [
   "svg",
   "jsx"
  ],
  "limits": null,
  "mcp": null,
  "mcp_url": null,
  "credit_line": "Icons: Iconoir (iconoir.com), MIT License",
  "rules_text": "- 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.\n  Connect: npm iconoir.\n  Get files: npm install iconoir (raw SVG) or iconoir-react; or copy SVG from iconoir.com. No account (svg, jsx).\n  Not allowed: MIT notice in redistributed source\n  Rule: Keep the license notice when you copy the source files\n  License: https://raw.githubusercontent.com/iconoir-icons/iconoir/main/LICENSE (checked 2026-11-09; details: https://agentgid.com/assets/iconoir/)",
  "agent_md": "https://agentgid.com/assets/iconoir/agent.md",
  "card_json": "https://agentgid.com/assets/iconoir/card.json"
 },
 "popularity": {
  "gid_score": 41,
  "stars": 4648,
  "downloads_7d": 47035,
  "downloads_7d_label": "47K",
  "downloads_change_4w_pct": 70.2,
  "eco": "npm",
  "package": "iconoir",
  "repo": "iconoir-icons/iconoir",
  "agent_projects": null,
  "agent_projects_total": null,
  "downloads_unconfirmed": false,
  "series": {
   "downloads_weekly": [
    [
     "2025-11-17",
     9852
    ],
    [
     "2025-11-24",
     7331
    ],
    [
     "2025-12-01",
     9798
    ],
    [
     "2025-12-08",
     7708
    ],
    [
     "2025-12-15",
     8016
    ],
    [
     "2025-12-22",
     4874
    ],
    [
     "2025-12-29",
     4735
    ],
    [
     "2026-01-05",
     6898
    ],
    [
     "2026-01-12",
     7396
    ],
    [
     "2026-01-19",
     8147
    ],
    [
     "2026-01-26",
     19259
    ],
    [
     "2026-02-02",
     11113
    ],
    [
     "2026-02-09",
     9491
    ],
    [
     "2026-02-16",
     9080
    ],
    [
     "2026-02-23",
     12504
    ],
    [
     "2026-03-02",
     9674
    ],
    [
     "2026-03-09",
     11448
    ],
    [
     "2026-03-16",
     10716
    ],
    [
     "2026-03-23",
     8885
    ],
    [
     "2026-03-30",
     13001
    ],
    [
     "2026-04-06",
     9670
    ],
    [
     "2026-04-13",
     10879
    ],
    [
     "2026-04-20",
     10024
    ],
    [
     "2026-04-27",
     14528
    ],
    [
     "2026-05-04",
     8967
    ],
    [
     "2026-05-11",
     11816
    ],
    [
     "2026-05-18",
     11996
    ],
    [
     "2026-05-25",
     10062
    ],
    [
     "2026-06-01",
     10736
    ],
    [
     "2026-06-08",
     12351
    ],
    [
     "2026-06-15",
     10607
    ],
    [
     "2026-06-22",
     11964
    ],
    [
     "2026-06-29",
     11786
    ],
    [
     "2026-07-06",
     14167
    ],
    [
     "2026-07-13",
     14167
    ],
    [
     "2026-07-20",
     13451
    ],
    [
     "2026-07-27",
     14386
    ],
    [
     "2026-08-03",
     14565
    ],
    [
     "2026-08-10",
     18796
    ],
    [
     "2026-08-17",
     13206
    ],
    [
     "2026-08-24",
     16798
    ],
    [
     "2026-08-31",
     19670
    ],
    [
     "2026-09-07",
     15255
    ],
    [
     "2026-09-14",
     16113
    ],
    [
     "2026-09-21",
     19633
    ],
    [
     "2026-09-28",
     21776
    ],
    [
     "2026-10-05",
     27370
    ],
    [
     "2026-10-12",
     26291
    ],
    [
     "2026-10-19",
     27876
    ],
    [
     "2026-10-26",
     42309
    ],
    [
     "2026-11-02",
     47042
    ],
    [
     "2026-11-09",
     44583
    ]
   ],
   "stars": [
    [
     "2026-11-07",
     4625
    ],
    [
     "2026-11-08",
     4626
    ],
    [
     "2026-11-09",
     4628
    ],
    [
     "2026-11-10",
     4631
    ],
    [
     "2026-11-11",
     4631
    ],
    [
     "2026-11-12",
     4636
    ],
    [
     "2026-11-13",
     4637
    ],
    [
     "2026-11-14",
     4641
    ],
    [
     "2026-11-15",
     4643
    ],
    [
     "2026-11-16",
     4643
    ],
    [
     "2026-11-17",
     4645
    ],
    [
     "2026-11-18",
     4647
    ],
    [
     "2026-11-19",
     4648
    ]
   ]
  },
  "stars_flat_since": null,
  "updated_at": "2026-11-19"
 },
 "alternatives": [
  {
   "slug": "iconoir",
   "name": "Iconoir",
   "why": null,
   "current": true,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "lucide",
   "name": "Lucide",
   "why": "Pick Lucide for a larger line icon set with ready packages for Svelte and Angular too, under the ISC license.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "phosphor",
   "name": "Phosphor Icons",
   "why": "Pick Phosphor when you want each icon in six weights instead of one line and one filled version.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "tabler-icons",
   "name": "Tabler Icons",
   "why": "Pick Tabler Icons for a much larger MIT set with more than a thousand filled icons.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "material-design-icons-pictogrammers",
   "name": "Material Design Icons (Pictogrammers)",
   "why": "Community Material Design icon set (7,000+ icons, as reported) as SVG, webfont and JS packages (@mdi/js, @mdi/font).",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "ionicons",
   "name": "Ionicons",
   "why": "An open-source icon set from Ionic, distributed under the MIT License.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  }
 ],
 "faq": [
  {
   "q": "Can I use Iconoir in a paid app or a client site?",
   "a": "Yes. It is MIT licensed and the project says you can use it in personal and commercial projects, apps, websites and products."
  },
  {
   "q": "Do I have to credit Iconoir?",
   "a": "No credit is needed to use the icons. Only when you pass on the library itself do you keep the MIT notice."
  },
  {
   "q": "Are there filled icons?",
   "a": "Yes, 288 icons have a solid version; the file names end in -solid and the React components in Solid, like HeartSolid."
  },
  {
   "q": "Which frameworks are supported?",
   "a": "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."
  },
  {
   "q": "Can I get a single icon as a PNG?",
   "a": "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."
  }
 ],
 "at_a_glance": {
  "latest_version": "7.12.2",
  "last_release": "2026-11-04",
  "last_commit": "2026-11-04",
  "runtime": "React 18 or 19 (peer dependency). React Native also needs react-native-svg. Our demo used the iconoir 7.12.2 SVG files.",
  "key_needed": false,
  "formats": "svg, jsx"
 },
 "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."
 ],
 "stack_snippets": [],
 "claims": [
  "1,383 icons, 288 of them also solid, 1,671 SVG files in total"
 ],
 "checked": {
  "license_read": "2026-11-09",
  "overview_checked": "2026-11-09",
  "numbers_updated": "2026-11-19",
  "sources": [
   {
    "label": "iconoir.com",
    "url": "https://iconoir.com"
   },
   {
    "label": "iconoir.com/docs/introduction",
    "url": "https://iconoir.com/docs/introduction"
   },
   {
    "label": "iconoir.com/docs/faq",
    "url": "https://iconoir.com/docs/faq"
   },
   {
    "label": "iconoir.com",
    "url": "https://iconoir.com/docs/packages/iconoir-react"
   },
   {
    "label": "iconoir.com/docs/packages/css",
    "url": "https://iconoir.com/docs/packages/css"
   },
   {
    "label": "iconoir.com/docs/naming-convention",
    "url": "https://iconoir.com/docs/naming-convention"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/iconoir-icons/iconoir/blob/main/README.md"
   },
   {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/iconoir-icons/iconoir/blob/main/LICENSE"
   },
   {
    "label": "npm: iconoir/latest",
    "url": "https://registry.npmjs.org/iconoir/latest"
   },
   {
    "label": "npm: iconoir-react/latest",
    "url": "https://registry.npmjs.org/iconoir-react/latest"
   },
   {
    "label": "npm: iconoir-react/7.12.2",
    "url": "https://registry.npmjs.org/iconoir-react/7.12.2"
   },
   {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/iconoir-icons/iconoir/main/LICENSE"
   }
  ],
  "unverified": null
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/iconoir/",
 "note": "Written by AgentGid from the official pages in checked.sources; quotes are copied from those pages. status: yes | cond | no | unknown | info. Prices and vendor claims are as reported on the checked date. Not legal advice."
}
