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@latest

1.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

IconExportAlso exported as
AbkhaziaAbkhazia
Estonia, mainland onlyEstoniaMainlandEeMainland
Cayman Islands, Grand CaymanCaymanIslandsGrandCaymanKyGrandCayman
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 IconProvider in 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 createGeoIcons from 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.01.4.1ISO export
CocosKeelingIslandsCocosIslandsCc
FalklandIslandsMalvinasFalklandIslandsFk
StateOfPalestinePalestinePs
HolySeeVaticanCityStateVaticanCityVa
SaintMartinFrenchPartSaintMartinMf
SintMaartenDutchPartSintMaartenSx

New aliases

  • Full-name aliases for 5 mainland and variant icons: AustraliaMainland (AuMainland), AzerbaijanMainland (AzMainland), BahrainMainland (BhMainland), BahamasAndros (BsAndros), and FranceMainland (FrMainland).
  • EuropeanUnion is now an area alias. EuropeanUnionEu still 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 UnitedStates bundles 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-texas becomes UsTexas. ISO 3166-2 codes weren't used as export names because 11 Caribbean countries have numeric ones, which would have produced exports like Jm01. The ISO 3166-2 code is still searchable on the site, so us-tx finds Texas.

  • Coverage (23 countries):

    CountryIconsCountryIcons
    United States51Honduras18
    Bahamas32Nicaragua17
    Dominican Republic32Cuba16
    Mexico32El Salvador14
    Guatemala22Jamaica14
    Canada13Saint Kitts and Nevis14
    Panama13Trinidad and Tobago14
    Barbados11Dominica10
    Haiti10Saint Lucia10
    Antigua and Barbuda8Costa Rica7
    Grenada7Belize6
    Saint Vincent and the Grenadines6

Fixes

  • Native Node ESM. Packages are "type": "module" but imported their own files without extensions, so import("@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 .js extension. 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 existing Scotland, Wales, and NorthernIreland constituent-country icons.

  • Removed: the Gb country 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, and core) 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 strokeWidth prop plus native stroke and fill attributes, themed with currentColor.
  • Accessibility built in: decorative by default, meaningful with aria-label.
  • Import by category: @geoicons/react/countries and @geoicons/react/areas.
  • Dual-licensed: GPLv3, or a permanent commercial key verified offline (no server call).