circle-flags circle-flags animated logo

A collection of circular square circular SVG country flags, based on square-flags, in turn based on circle-flags, by HatScripts.

Why a fork? What’s different?

In the process of creating the square-flags flag set to provide square variants to those provided by the original circle-flags repo, with adjustments to better fit the square format, I ended up making numerous further improvements to the original artwork in a number of places, and adjustments to colours to provide better contrast, more accurately reflect the source flag and so on.

It seemed to me the natural thing to do would be to ‘port back’ those improvements to the circular format, and so I’ve created a figma file where I can maintain these alterations. This repo might potentially be merged back in with the original, but in the meantime I’m making my versions available here.

I’ve also added a small number of other flags to the project (as with square-flags) which may or may not be interesting to you.

Usage

https://kapowaz.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://kapowaz.github.io/circle-flags/flags/br.svg" width="48">
<img src="https://kapowaz.github.io/circle-flags/flags/cn.svg" width="48">
<img src="https://kapowaz.github.io/circle-flags/flags/gb.svg" width="48">
<img src="https://kapowaz.github.io/circle-flags/flags/id.svg" width="48">
<img src="https://kapowaz.github.io/circle-flags/flags/in.svg" width="48">
<img src="https://kapowaz.github.io/circle-flags/flags/ng.svg" width="48">
<img src="https://kapowaz.github.io/circle-flags/flags/ru.svg" width="48">
<img src="https://kapowaz.github.io/circle-flags/flags/us.svg" width="48">

…produces this:

To view all the available flags, check the gallery.

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/kapowaz/circle-flags

Contributing

The design files for this set of flags can be found on Figma as part of the Circle Flags shared library. If you wish to make a contribution, create a copy of that library and add your changes as a component, then create a pull request including the exported SVG file and a link to your copy of the Figma file, so that the original can be updated.

You will also need to ensure you have have the latest version of svgo installed; when exporting SVG files, run svgo on the flags/ directory:

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

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

The color palette

Like HatScript’s flag set, this set of flags uses the following color palette (with a few small additions, such as Dark Yellow). Since the original designs are in Figma, if you have a proposed modification to an existing flag, create an issue and I’ll try and amend the original Figma file.

License

This project is released under the MIT license.