Skip to content

@xinnovations/atlasWorld Location Data

Complete data for countries, states, and cities with zero dependencies

Quick Example

typescript
import { getStates, getCities, searchCountries } from '@xinnovations/atlas';

// Get states for a country
const states = getStates('United States');
console.log(states);

// Get cities for a state
const cities = getCities('Nigeria', 'Lagos');
console.log(cities); // ['Apapa', 'Ikeja', ...]

// Search for countries
const results = searchCountries('united');
console.log(results.map(c => c.name));
// ['United Arab Emirates', 'United Kingdom', 'United States', ...]

Installation

bash
npm install @xinnovations/atlas
bash
yarn add @xinnovations/atlas
bash
pnpm add @xinnovations/atlas

What's Included?

Country Data

  • Country names and currency codes
  • Emoji flags
  • States/provinces
  • Cities

Functions

  • Country queries and searches
  • State lookups
  • City searches
  • Fuzzy search capabilities

License

MIT © Solomon Olatunji


Made with ❤️ in Nigeria 🇳🇬 for the World 🌍

Released under the MIT License.