OpenCut/docs/countries-search.md

52 lines
1.6 KiB
Markdown

# 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.
| Region | Examples |
|---|---|
| Northern Europe | Denmark, Sweden, Norway, Finland, Iceland |
| Western Europe | France, Germany, Switzerland, UK, Netherlands |
| Southern Europe | Italy, Spain, Greece, Portugal |
| Eastern Europe | Poland, Russia, Czech Republic, Hungary |
| Middle East | Saudi Arabia, UAE, Israel, Turkey |
| East Asia | Japan, China, South Korea |
| Southeast Asia | Thailand, Vietnam, Indonesia, Singapore |
| South Asia | India, Pakistan, Bangladesh |
| Central Asia | Kazakhstan, Uzbekistan |
| North Africa | Egypt, Morocco, Tunisia |
| Sub-Saharan Africa | Nigeria, Kenya, South Africa, Ethiopia |
| North America | USA, Canada, Mexico |
| Central America | Panama, Costa Rica, Guatemala |
| Caribbean | Cuba, Bahamas, Jamaica |
| South America | Brazil, Argentina, Colombia |
| Oceania | Australia, New Zealand |
| Atlantic Ocean | Ascension Island, Saint Helena |
| North Atlantic | Bermuda |