Circle Flags Icons for React.

Circle Flags has 731 icons by HatScripts, drawn on a 512 × 512 grid.

HatScripts made Circle Flags, released under MIT.

Circle Flags is in the Flags and maps group on the libraries page. Sets like it are Temaki, Flag Icons and Röntgen. Open each to compare the grid, the style and the license before you pick one.

Search by name or by what an icon shows: each one is tagged with words like "money" or "navigation", so you find it without knowing its exact name. Search runs inside Circle Flags, over its 731 icons.

Every Circle Flags icon's page has an Other libraries section with the same icon drawn by other sets, and its tags link to every library that draws the same subject. Use them to compare Circle Flags with the rest.

Open an icon, then copy it as a typed React component or as SVG for any framework or design tool. Signed in, you can also install it with one shadcn CLI command.

Open a Circle Flags icon, then Get icon, and copy it as React, Vue, Svelte, Angular, Solid, Preact, SVG, or as a data URL. Each is one self-contained component or file with the SVG inside.

Open the icon's page, choose Get icon, then Install with shadcn CLI. The CLI adds one file, components/icons/<icon>.tsx, with a size prop and every SVG prop; its first line names Circle Flags, HatScripts and MIT. It needs a free account.

Copy it. Circle Flags has no package here, so each icon you install is one small file in your project with no dependency, and only the icons you import reach your bundle.

Circle Flags icons are multicolor, so they keep their own colors.

Circle Flags is drawn on a 512 × 512 grid. Set width and height on the component, or a class like size-6, and it stays sharp at any size; Customize also sets the size it exports at.

Tailwind text classes: multicolor icons ignore them, so size them with size-6 and leave the color to the icon. On an installed icon, className reaches the svg like any prop.

Next to a visible label, a Circle Flags icon is decoration: add aria-hidden="true" so screen readers skip it. Alone, as in an icon-only button, name the button with aria-label instead. The installed component passes every SVG prop through, so both work on it.

Circle Flags icons keep their own colors, so check each against your background yourself: icons that carry meaning need 3:1 contrast (WCAG 1.4.11).

Yes. MIT allows commercial use; keep the license notice when you ship the icons' source files. The full terms are in the license, linked on this page.

No visible credit is required: MIT only asks that you keep the license notice if you ship the icons' source files. Icons installed with the shadcn CLI already start with a comment naming Circle Flags, HatScripts and the license.

Yes. Every Circle Flags icon is free to browse, copy and download here. Pro adds the MCP server, which installs icons for your AI agent.

With Pro, the shadcn.io MCP server lets Claude Code, Cursor or any MCP client search every library and install the Circle Flags icon you ask for, with search_icons, get_icon and list_icon_libraries.

Circle Flags has no npm package here, so get_icon adds the icon as a component: one shadcn CLI command for React, or the code and the file to save it at for Vue, Svelte and other frameworks.