No description
Find a file
HatScripts bc36c9ad7f Add SVG color swatches to palette in README
Replaces plain color codes in the color palette section with inline SVG circles for visual reference, improving clarity for contributors selecting flag colors.
2025-12-11 22:27:57 +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 Add flag for Belgorod People's Republic (Closes #123) 2025-12-11 22:13:29 +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 flag for Belgorod People's Republic (Closes #123) 2025-12-11 22:13:29 +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 Add SVG color swatches to palette in README 2025-12-11 22:27:57 +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.