Back to Opencut

Countries search — Data Guide

docs/countries-search.md

0.3.01.6 KB
Original Source

Countries search — Data Guide

Structure

Each country entry in apps/web/public/countries.json follows this shape:

json
{
  "name": "Denmark",
  "code": "DK",
  "languages": ["danish"],
  "flag_colors": ["red", "white"],
  "region": "Northern Europe"
}

name

Use the commonly recognized country or territory name.

code

Use the canonical country/territory code.

flag_colors

Canonical color names only: red, white, blue, green, yellow, black, orange, purple.

languages

The official or widely spoken languages.

region

Consistent values — don't mix "Europe" and "Western Europe" for the same type of country.

RegionExamples
Northern EuropeDenmark, Sweden, Norway, Finland, Iceland
Western EuropeFrance, Germany, Switzerland, UK, Netherlands
Southern EuropeItaly, Spain, Greece, Portugal
Eastern EuropePoland, Russia, Czech Republic, Hungary
Middle EastSaudi Arabia, UAE, Israel, Turkey
East AsiaJapan, China, South Korea
Southeast AsiaThailand, Vietnam, Indonesia, Singapore
South AsiaIndia, Pakistan, Bangladesh
Central AsiaKazakhstan, Uzbekistan
North AfricaEgypt, Morocco, Tunisia
Sub-Saharan AfricaNigeria, Kenya, South Africa, Ethiopia
North AmericaUSA, Canada, Mexico
Central AmericaPanama, Costa Rica, Guatemala
CaribbeanCuba, Bahamas, Jamaica
South AmericaBrazil, Argentina, Colombia
OceaniaAustralia, New Zealand
Atlantic OceanAscension Island, Saint Helena
North AtlanticBermuda