No description
Find a file
2025-12-13 20:15:31 +11:00
.github Add PayPal link to FUNDING.yml 2023-07-06 20:16:06 +10:00
_layouts Make project name link white 2022-05-05 22:16:14 +10:00
flags Update Mexico flag - eagle and snake 2025-12-13 20:15:31 +11:00
.gitattributes Add .gitattributes and .gitignore files for SVG handling and node_modules exclusion 2025-12-08 18:03:20 +00:00
.gitignore Update .gitignore with additional patterns 2025-12-09 11:49:40 +11:00
_config.yml Set theme jekyll-theme-cayman 2018-12-06 00:43:05 +11:00
favicon.ico Update favicon.ico to include more sizes 2021-06-29 14:38:56 +10:00
gallery.css Revert "Move flag image sizing from HTML to CSS" 2025-12-08 19:12:01 +11:00
gallery.md Add Malta civil ensign flag 2025-12-13 15:56:10 +11:00
LICENSE.md Update copyright year 2024-04-03 13:00:54 +11:00
logo.svg Update logo - shorten flag 2025-12-06 19:48:17 +11:00
package.json Add package.json & instructions how to install with NPM 2020-12-17 18:40:05 +02:00
README.md Update color palette icons in README 2025-12-12 12:36:35 +11:00
svgo.config.js Update SVGO config 2025-12-09 11:50:53 +11:00

circle-flags circle-flags animated logo

A collection of circular SVG country flags.

Usage

https://hatscripts.github.io/circle-flags/flags/xx.svg

(Where xx is the ISO 3166-1 alpha-2 code of a country).

For example, the following code:

<img src="https://hatscripts.github.io/circle-flags/flags/br.svg" width="48" />
<img src="https://hatscripts.github.io/circle-flags/flags/cn.svg" width="48" />
<img src="https://hatscripts.github.io/circle-flags/flags/gb.svg" width="48" />
<img src="https://hatscripts.github.io/circle-flags/flags/id.svg" width="48" />
<img src="https://hatscripts.github.io/circle-flags/flags/in.svg" width="48" />
<img src="https://hatscripts.github.io/circle-flags/flags/ng.svg" width="48" />
<img src="https://hatscripts.github.io/circle-flags/flags/ru.svg" width="48" />
<img src="https://hatscripts.github.io/circle-flags/flags/us.svg" width="48" />

...produces this:

To view all the available flags, check the gallery.

React

If you're using React, you may want to try the react-circle-flags package.

SolidJS

If you're using SolidJS, you may want to try the solid-circle-flags package.

NPM

If you want to install this package as a dependency, you can install it from this GitHub repository:

npm install --save https://github.com/HatScripts/circle-flags

📜 Userscripts

🚀 Contributing

To contribute, you need to have the latest version of svgo installed.

First, edit the relevant SVG files in the flags/ directory.

Then run svgo to optimize the SVG files:

svgo ./flags --recursive --config=svgo.config.js

Then commit the changes, and submit them as a pull request.

🎨 The color palette

Submitted flags should conform to the following color palette.
Try to match the flag's original colors with the nearest color from the palette.

  • #eeeeee: white
  • #acabb1: gray
  • #333333: black
  • #a2001d: dark red
  • #d80027: red
  • #ff9811: orange
  • #ffda44: yellow
  • #6da544: green
  • #496e2d: dark green
  • #338af3: light blue
  • #0052b4: blue

Special cases:

🧾 License

This project is released under the MIT license.