Changelog
Since 1.1.0 every @geoicons/* package ships on the same version number, so one
entry covers React, Vue, Angular, and Vanilla. Examples below use React; the other
packages expose the same export names and entry points.
To update, install the latest version of your framework package:
npm install @geoicons/react@latest1.5.0 (2026-11-01)
Redrawn icons
81 country icons were redrawn with cleaner, more accurate outlines. This is a visual change only: export names, props, and the 24×24 viewBox are unchanged, so no code changes are needed. If you snapshot-test rendered SVG markup, expect these icons' path data to differ.
Redrawn: Afghanistan, Albania, Algeria, American Samoa, Andorra, Angola, Anguilla, Antigua and Barbuda, Argentina, Armenia, Aruba, Australia (and Australia mainland), Austria, Azerbaijan (and Azerbaijan mainland), Bahamas (and Andros), Bahrain (and Bahrain mainland), Bangladesh, Barbados, Belarus, Belgium, Belize, Benin, Bermuda, Bhutan, Bolivia, Bonaire, Bosnia and Herzegovina, Botswana, Bouvet Island, Brazil, British Virgin Islands, Brunei, Bulgaria, Burkina Faso, Burundi, Cambodia, Cameroon, Canada, Cape Verde, Cayman Islands, Central African Republic, Chad, Chile, China, Christmas Island, Colombia, Comoros, Costa Rica, Côte d'Ivoire, Croatia, Cuba, Curaçao, Czechia, Denmark, Djibouti, Dominica, Dominican Republic, DR Congo, Estonia, France, French Polynesia, Gabon, Gambia, Georgia, Germany, Ghana, Gibraltar, Greece, Greenland, Grenada, Guadeloupe, Guam, Guatemala, Guernsey, Guinea, Guinea-Bissau, and Guyana.
New icons
| Icon | Export | Also exported as |
|---|---|---|
| Abkhazia | Abkhazia | |
| Estonia, mainland only | EstoniaMainland | EeMainland |
| Cayman Islands, Grand Cayman | CaymanIslandsGrandCayman | KyGrandCayman |
import { Abkhazia, EstoniaMainland } from "@geoicons/react/countries";The catalog is now 802 icons: 258 countries & territories, 167 areas, and 377 subdivisions.
1.4.2 (2026-10-23)
- License key rotation. The public key used to verify commercial license keys
was rotated. License keys signed with the previous key no longer verify from
this version on. Existing license holders receive a re-issued key; swap it in
wherever you pass your license key (for example
IconProviderin React) when you upgrade. - Nothing breaks visually if you upgrade before swapping keys: icons keep rendering, and an unverified key only brings back the console warning.
- Docs: Vanilla examples now import
createGeoIconsfrom the package root.
1.4.1 (2026-08-25)
Renamed aliases
Six full-name country aliases from 1.4.0 were shortened to drop official-name clutter. The old names were removed, so update these imports if you adopted them in 1.4.0. The ISO exports did not change.
| 1.4.0 | 1.4.1 | ISO export |
|---|---|---|
CocosKeelingIslands | CocosIslands | Cc |
FalklandIslandsMalvinas | FalklandIslands | Fk |
StateOfPalestine | Palestine | Ps |
HolySeeVaticanCityState | VaticanCity | Va |
SaintMartinFrenchPart | SaintMartin | Mf |
SintMaartenDutchPart | SintMaarten | Sx |
New aliases
- Full-name aliases for 5 mainland and variant icons:
AustraliaMainland(AuMainland),AzerbaijanMainland(AzMainland),BahrainMainland(BhMainland),BahamasAndros(BsAndros), andFranceMainland(FrMainland). EuropeanUnionis now an area alias.EuropeanUnionEustill works.
1.4.0 (2026-08-25)
Full-name country imports
246 country and territory icons can now be imported by full name as well as by ISO 3166-1 alpha-2 code. Both names point to the same component:
import { UnitedStates, Japan } from "@geoicons/react/countries";
// same components as:
import { Us, Jp } from "@geoicons/react/countries";- The aliases are additive. Existing ISO imports keep working, and the ISO code stays the canonical id.
- Tree-shaking is unchanged: an alias is a re-export, so importing
UnitedStatesbundles exactly one icon. - Package READMEs now lead with full-name examples.
1.3.0 (2026-08-23)
Subdivision icons
377 subdivision icons for North America and the Caribbean: states, provinces,
parishes, and departments. They ship from a new subdivisions entry point in all
four packages.
import { UsTexas, CaOntario, JmKingston } from "@geoicons/react/subdivisions";-
Naming: the parent country's ISO code plus the subdivision name, so
us-texasbecomesUsTexas. ISO 3166-2 codes weren't used as export names because 11 Caribbean countries have numeric ones, which would have produced exports likeJm01. The ISO 3166-2 code is still searchable on the site, sous-txfinds Texas. -
Coverage (23 countries):
Country Icons Country Icons United States 51 Honduras 18 Bahamas 32 Nicaragua 17 Dominican Republic 32 Cuba 16 Mexico 32 El Salvador 14 Guatemala 22 Jamaica 14 Canada 13 Saint Kitts and Nevis 14 Panama 13 Trinidad and Tobago 14 Barbados 11 Dominica 10 Haiti 10 Saint Lucia 10 Antigua and Barbuda 8 Costa Rica 7 Grenada 7 Belize 6 Saint Vincent and the Grenadines 6
Fixes
- Native Node ESM. Packages are
"type": "module"but imported their own files without extensions, soimport("@geoicons/react/countries")failed under plain Node (for example in SSR scripts or tests run without a bundler). Every internal import now carries an explicit.jsextension. Bundler users see no change, and Angular was never affected.
The catalog is now 799 icons: 255 countries & territories, 167 areas, and 377 subdivisions.
1.2.0 (2026-07-17)
-
New:
England, matching the existingScotland,Wales, andNorthernIrelandconstituent-country icons. -
Removed: the
Gbcountry export, which duplicated the United Kingdom area icon. If you imported it, switch to the area:// before import { Gb } from "@geoicons/react/countries"; // after import { UnitedKingdom } from "@geoicons/react/areas"; -
Standardized the spelling "tree-shakable" across packages and READMEs.
1.1.1 (2026-07-11)
- Package metadata only: consistent npm descriptions across the four framework packages, corrected icon counts, and broader keywords. No code changes.
1.1.0 (2026-07-10)
- Lockstep versioning. All
@geoicons/*packages (react,vue,angular,vanilla, andcore) now share one version number, so matching versions always work together. - Updated the commercial license agreement wording.
1.0.0
- Initial release of GeoIcons for React, Vue, Angular, and Vanilla JS.
- 422 geographic map icons as tree-shakable components: 255 countries & territories plus 167 areas (continents, sub-regions, blocs, and landforms).
- Continuous styling via the
strokeWidthprop plus nativestrokeandfillattributes, themed withcurrentColor. - Accessibility built in: decorative by default, meaningful with
aria-label. - Import by category:
@geoicons/react/countriesand@geoicons/react/areas. - Dual-licensed: GPLv3, or a permanent commercial key verified offline (no server call).