{
 "slug": "mingcute-icons",
 "name": "MingCute Icons",
 "author": "MingCute Design",
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "Open-source set of 2,263 icons in Core Regular and Core Filled styles (4,526 SVGs, as reported in the README) as SVG, icon font and React/Vue packages.",
 "category": {
  "slug": "icons",
  "name": "Icons"
 },
 "tags": [
  "Code library",
  "Open source"
 ],
 "styles": [
  "outline",
  "flat",
  "minimal"
 ],
 "logo_url": "https://agentgid.com/media/avatars/mingcute-design.png",
 "logo_letter": "M",
 "links": {
  "repo": "https://github.com/mingcute-design/mingcute-icons",
  "website": "https://www.mingcute.com",
  "api_docs": null
 },
 "preview": {
  "kind": "image_grid",
  "src": "https://agentgid.com/assets/mingcute-icons/demo.jpg",
  "alt": "A phone settings screen with a tab bar where the active tab uses the filled icon, 20 icons shown as outline and filled pairs, and a row of buttons.",
  "caption": "Made by AgentGid with @mingcute/svg 3.1.0 (npm). MingCute Icons are under the Apache License 2.0, which allows showing and passing on the icons; a copy of the license goes with copies of the files."
 },
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Free",
   "status": "yes",
   "sub": "No paid plan",
   "quote": null,
   "note": "Fully free.",
   "source": {
    "label": "mingcute.com",
    "url": "https://www.mingcute.com"
   },
   "n": 1
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "Yes",
   "status": "yes",
   "sub": "Apache-2.0",
   "quote": "each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.",
   "note": "Apache 2.0 allows use in paid products at no charge.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/mingcute-design/mingcute-icons/main/LICENSE"
   },
   "n": 2
  },
  {
   "key": "credit",
   "label": "Credit the author",
   "value": "Not needed",
   "status": "yes",
   "sub": "Keep the notice in code copies",
   "quote": "You must give any other recipients of the Work or Derivative Works a copy of this License",
   "note": "No credit on screen. Keep the license notice inside the code you ship.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/mingcute-design/mingcute-icons/main/LICENSE"
   },
   "n": 3
  },
  {
   "key": "agent_access",
   "label": "Agent access",
   "value": "MCP server",
   "status": "info",
   "sub": "Official server",
   "quote": null,
   "note": "An agent can install it by itself with npm install @mingcute/react. No key or account is needed.",
   "source": {
    "label": "github.com/mingcute-design/mingcute-icons",
    "url": "https://github.com/mingcute-design/mingcute-icons"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "Apache-2.0",
  "url": "https://raw.githubusercontent.com/mingcute-design/mingcute-icons/main/LICENSE",
  "summary": "Apache 2.0 license: free in personal and paid products, with no visible credit needed. When you pass the icon files on, include a copy of the license.",
  "pages_read": 1,
  "rules": [
   "Keep the Apache-2.0 license with redistributed files",
   "Old package mingcute_icon moved to @mingcute/svg and @mingcute/font"
  ],
  "rows": [
   {
    "label": "Commercial use",
    "value": "Yes",
    "status": "yes",
    "quote": "each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/mingcute-design/mingcute-icons/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Credit",
    "value": "Not needed",
    "status": "yes",
    "quote": "You must give any other recipients of the Work or Derivative Works a copy of this License",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/mingcute-design/mingcute-icons/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Inside your app or game",
    "value": "Can ship inside your app",
    "status": "yes",
    "quote": "each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/mingcute-design/mingcute-icons/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Pass the files on to your users",
    "value": "Allowed",
    "status": "yes",
    "quote": "each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/mingcute-design/mingcute-icons/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/mingcute-icons/commercial-use/"
 },
 "overview": {
  "heading": "MingCute Icons: rounded icons in outline and filled",
  "body": "MingCute Icons is a free set of a little over two thousand rounded icons, each drawn twice, as an outline and as a filled shape. You or your AI assistant add them to a website or app as ready pieces for React, Vue and other tools, or as plain picture files. They are free for paid products too."
 },
 "uses": [
  {
   "title": "Tab bars with an active state",
   "text": "Show the outline icon for the tabs you are not on and the filled one for the current tab, so people see at once where they are.",
   "idea": true,
   "image": null
  },
  {
   "title": "Menus and links in a React app",
   "text": "Each icon is its own small piece you put next to a menu item or inside a button, such as a house next to Home.",
   "idea": false,
   "image": null
  },
  {
   "title": "Icons in Vue, Svelte or mobile apps",
   "text": "The same icons come as ready pieces for Vue, Svelte, SolidJS and React Native, so a web app and a phone app can share one look.",
   "idea": false,
   "image": null
  },
  {
   "title": "Icon files on a simple website",
   "text": "Copy the icon files into your site and use them as images or backgrounds, on pages built without any framework.",
   "idea": false,
   "image": null
  },
  {
   "title": "Icons in a content editor or old template",
   "text": "Add an icon with one class name through the icon font, for example in a CMS template where you cannot add code.",
   "idea": false,
   "image": null
  },
  {
   "title": "Settings and account screens",
   "text": "Give each settings row its own icon: notifications, dark mode, language, billing, privacy. The list reads faster and looks tidy.",
   "idea": true,
   "image": null
  }
 ],
 "start": {
  "prompt": "Add @mingcute/react at version 3.1.0: outline icons from @mingcute/react/core-regular for the tab bar and the filled one from core-filled for the active tab, size 24, aria-hidden when a text label is next to the icon.",
  "install": "npm install @mingcute/react",
  "install_note": "Vue, Svelte, SolidJS, React Native, plain JavaScript, SVG files and an icon font also exist).",
  "code": [
   {
    "tab": "React",
    "intro": "Import an icon from the style folder (core-regular or core-filled) and place it.",
    "source": "import { Home1Regular } from '@mingcute/react/core-regular';\n\nexport function HomeIcon() {\n  return <Home1Regular size={24} title=\"Home\" />;\n}"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "npm install mingcute_icon",
   "fix": "npm install @mingcute/svg or @mingcute/font (or the framework package such as @mingcute/react)",
   "why": "The old package is retired and points to the new ones.",
   "dont_code": true,
   "fix_code": true
  },
  {
   "dont": "import { Home1Regular } from '@mingcute/react'",
   "fix": "import { Home1Regular } from '@mingcute/react/core-regular' (or the direct path '@mingcute/react/core-regular/home-1')",
   "why": "The package root holds only shared helpers and types, not the icons.",
   "dont_code": true,
   "fix_code": true
  },
  {
   "dont": "Icon names from version 2, such as docment or barcode-sca, or the old class names",
   "fix": "Look up current names in the 3.x package (e.g. document, barcode-scan) or the icon mapping file",
   "why": "Version 3.1.0 uses new names without aliases for the old ones.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "<img src=\"/node_modules/@mingcute/svg/core-regular/home-1.svg\">",
   "fix": "Copy the files you use into the site's public folder during the build, or import them through the bundler",
   "why": "The docs say not to serve package files straight from node_modules.",
   "dont_code": true,
   "fix_code": false
  },
  {
   "dont": "<button><MenuRegular /></button> with no name",
   "fix": "<button type=\"button\" aria-label=\"Open navigation\"><MenuRegular size={20} aria-hidden=\"true\" /></button>",
   "why": "Icons are decorative by default, so an icon-only button needs its own accessible name.",
   "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 @mingcute/react",
  "repo": "https://github.com/mingcute-design/mingcute-icons",
  "api_docs": null,
  "api_account": "Not needed. Everything runs on your side.",
  "get_files": "npm install @mingcute/react (or @mingcute/svg / @mingcute/font). No account.",
  "formats": [
   "svg",
   "jsx",
   "woff2"
  ],
  "limits": null,
  "mcp": "official",
  "mcp_url": null,
  "credit_line": "Icons: MingCute Icons (mingcute.com), Apache License 2.0",
  "rules_text": "- MingCute Icons (Icons). Open-source set of 2,263 icons in Core Regular and Core Filled styles (4,526 SVGs, as reported in the README) as SVG, icon font and React/Vue packages. Price: free; commercial use OK; no credit needed. Style: outline, flat, minimal.\n  Connect: npm @mingcute/react.\n  Get files: npm install @mingcute/react (or @mingcute/svg / @mingcute/font). No account (svg, jsx, woff2).\n  Not allowed: Apache-2.0 notice\n  Rule: Keep the Apache-2.0 license with redistributed files\n  Rule: Old package mingcute_icon moved to @mingcute/svg and @mingcute/font\n  License: https://raw.githubusercontent.com/mingcute-design/mingcute-icons/main/LICENSE (checked 2026-11-09; details: https://agentgid.com/assets/mingcute-icons/)",
  "agent_md": "https://agentgid.com/assets/mingcute-icons/agent.md",
  "card_json": "https://agentgid.com/assets/mingcute-icons/card.json"
 },
 "popularity": {
  "gid_score": 27,
  "stars": 1657,
  "downloads_7d": 11291,
  "downloads_7d_label": "11.3K",
  "downloads_change_4w_pct": 28.5,
  "eco": "npm",
  "package": "@mingcute/react",
  "repo": "mingcute-design/mingcute-icons",
  "agent_projects": null,
  "agent_projects_total": null,
  "downloads_unconfirmed": false,
  "series": {
   "downloads_weekly": [
    [
     "2025-12-15",
     139
    ],
    [
     "2025-12-22",
     257
    ],
    [
     "2025-12-29",
     224
    ],
    [
     "2026-01-05",
     155
    ],
    [
     "2026-01-12",
     115
    ],
    [
     "2026-01-19",
     247
    ],
    [
     "2026-01-26",
     193
    ],
    [
     "2026-02-02",
     137
    ],
    [
     "2026-02-09",
     198
    ],
    [
     "2026-02-16",
     351
    ],
    [
     "2026-02-23",
     486
    ],
    [
     "2026-03-02",
     506
    ],
    [
     "2026-03-09",
     634
    ],
    [
     "2026-03-16",
     657
    ],
    [
     "2026-03-23",
     824
    ],
    [
     "2026-03-30",
     1158
    ],
    [
     "2026-04-06",
     1634
    ],
    [
     "2026-04-13",
     1998
    ],
    [
     "2026-04-20",
     1600
    ],
    [
     "2026-04-27",
     2230
    ],
    [
     "2026-05-04",
     2306
    ],
    [
     "2026-05-11",
     2322
    ],
    [
     "2026-05-18",
     1294
    ],
    [
     "2026-05-25",
     1225
    ],
    [
     "2026-06-01",
     1633
    ],
    [
     "2026-06-08",
     1517
    ],
    [
     "2026-06-15",
     1523
    ],
    [
     "2026-06-22",
     2015
    ],
    [
     "2026-06-29",
     2037
    ],
    [
     "2026-07-06",
     2371
    ],
    [
     "2026-07-13",
     2850
    ],
    [
     "2026-07-20",
     3224
    ],
    [
     "2026-07-27",
     5408
    ],
    [
     "2026-08-03",
     5298
    ],
    [
     "2026-08-10",
     4046
    ],
    [
     "2026-08-17",
     4420
    ],
    [
     "2026-08-24",
     3548
    ],
    [
     "2026-08-31",
     4579
    ],
    [
     "2026-09-07",
     3284
    ],
    [
     "2026-09-14",
     4166
    ],
    [
     "2026-09-21",
     8643
    ],
    [
     "2026-09-28",
     13349
    ],
    [
     "2026-10-05",
     8914
    ],
    [
     "2026-10-12",
     6046
    ],
    [
     "2026-10-19",
     10857
    ],
    [
     "2026-10-26",
     11810
    ],
    [
     "2026-11-02",
     13509
    ],
    [
     "2026-11-09",
     11291
    ]
   ],
   "stars": [
    [
     "2026-11-07",
     1655
    ],
    [
     "2026-11-08",
     1655
    ],
    [
     "2026-11-09",
     1655
    ],
    [
     "2026-11-10",
     1655
    ],
    [
     "2026-11-11",
     1655
    ],
    [
     "2026-11-12",
     1655
    ],
    [
     "2026-11-13",
     1657
    ],
    [
     "2026-11-14",
     1657
    ],
    [
     "2026-11-15",
     1657
    ],
    [
     "2026-11-16",
     1657
    ],
    [
     "2026-11-17",
     1657
    ]
   ]
  },
  "stars_flat_since": null,
  "updated_at": "2026-11-17"
 },
 "alternatives": [
  {
   "slug": "mingcute-icons",
   "name": "MingCute Icons",
   "why": null,
   "current": true,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "MCP, npm"
  },
  {
   "slug": "lucide",
   "name": "Lucide",
   "why": "Pick Lucide for thin line icons whose line width you can change, under the ISC license.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "tabler-icons",
   "name": "Tabler Icons",
   "why": "Pick Tabler Icons for a larger MIT set (over 6,000 icons) that also has outline and filled versions.",
   "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 two styles.",
   "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 MingCute icons in a paid app or client project?",
   "a": "Yes. The Apache License 2.0 grants a free, worldwide license to copy, show and distribute the icons; pass on a copy of the license with the files."
  },
  {
   "q": "What is the difference between Regular and Filled?",
   "a": "They are the same 2,263 icons drawn as outlines (Core Regular, a 2 px line) and as solid shapes (Core Filled)."
  },
  {
   "q": "Can I change size and color?",
   "a": "Yes. Components take size (default 24) and color (default the text color); the plain files use the text color too."
  },
  {
   "q": "Where can I search the icons?",
   "a": "On the MingCute website, which also lets you preview, recolor and download single icons; there is a Figma plugin too."
  },
  {
   "q": "Is there a tool for AI coding assistants?",
   "a": "Yes. The project publishes an MCP server on npm for searching and using the icons from an assistant."
  }
 ],
 "at_a_glance": {
  "latest_version": "3.1.0",
  "last_release": "2026-07-31",
  "last_commit": "2026-11-05",
  "runtime": "React 18 or 19; ESM only. All ten public packages share version 3.1.0; our demo used @mingcute/svg 3.1.0.",
  "key_needed": false,
  "formats": "svg, jsx, woff2"
 },
 "good_to_know": [
  "The free set has two styles, outline and filled. The Cute and Sharp styles belong to the paid Pro version with its own license.",
  "Version 3 renamed many icons and dropped old names, and the old mingcute_icon package is retired. Code written for version 2 needs new names.",
  "The React pieces need React 18 or 19; the Vue ones need Vue 3.5 or newer.",
  "No account is needed for the free packages. The Pro packages need a paid plan and a private download setup.",
  "The icon font cannot show every detail, such as gradients or brand colors; use the picture files or ready pieces for those."
 ],
 "stack_snippets": [],
 "claims": [
  "2,263 icons in each of Core Regular and Core Filled, 4,526 styled icons in all",
  "The latest release grew each style from 1,663 to 2,263 icons"
 ],
 "checked": {
  "license_read": "2026-11-09",
  "overview_checked": "2026-11-09",
  "numbers_updated": "2026-11-17",
  "sources": [
   {
    "label": "mingcute.com",
    "url": "https://www.mingcute.com"
   },
   {
    "label": "github.com/mingcute-design/mingcute-icons",
    "url": "https://github.com/mingcute-design/mingcute-icons"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/mingcute-design/mingcute-icons/blob/main/README.md"
   },
   {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/mingcute-design/mingcute-icons/blob/main/LICENSE"
   },
   {
    "label": "github.com/mingcute-design/mingcute-icons/blob/main/CHANGELOG.md",
    "url": "https://github.com/mingcute-design/mingcute-icons/blob/main/CHANGELOG.md"
   },
   {
    "label": "github.com/mingcute-design/mingcute-icons/blob/main/release.json",
    "url": "https://github.com/mingcute-design/mingcute-icons/blob/main/release.json"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/mingcute-design/mingcute-icons/blob/main/packages/svg/README.md"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/mingcute-design/mingcute-icons/blob/main/packages/react/README.md"
   },
   {
    "label": "npm: @mingcute/react",
    "url": "https://registry.npmjs.org/@mingcute/react"
   },
   {
    "label": "npm: @mingcute/react/3.1.0",
    "url": "https://registry.npmjs.org/@mingcute/react/3.1.0"
   },
   {
    "label": "npm: @mingcute/svg/3.1.0",
    "url": "https://registry.npmjs.org/@mingcute/svg/3.1.0"
   },
   {
    "label": "npm: @mingcute/font",
    "url": "https://registry.npmjs.org/@mingcute/font"
   },
   {
    "label": "npm: @mingcute/vue",
    "url": "https://registry.npmjs.org/@mingcute/vue"
   },
   {
    "label": "npm: mingcute_icon",
    "url": "https://registry.npmjs.org/mingcute_icon"
   },
   {
    "label": "npm: @mingcute/mcp-server/0.2.0",
    "url": "https://registry.npmjs.org/@mingcute/mcp-server/0.2.0"
   },
   {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/mingcute-design/mingcute-icons/main/LICENSE"
   }
  ],
  "unverified": null
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/mingcute-icons/",
 "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."
}
