indian-atlas

Indian Atlas ๐Ÿ‡ฎ๐Ÿ‡ณ

Indian Atlas is an open-source project providing structured data of Indian states and their cities. The goal is to offer a developer-friendly dataset that can be used for applications like dropdowns, location pickers, maps, and more.

GitHub repo size GitHub stars License


๐Ÿ”— Live Website

๐ŸŒ https://vipinwap07.github.io/indian-atlas
Hosted via GitHub Pages using Next.js 14.


๐Ÿ“ Project Structure

indian-atlas/
โ”œโ”€โ”€ public/
โ”‚   โ””โ”€โ”€ data/
โ”‚       โ””โ”€โ”€ states-cities.json    # JSON file of states and cities
โ”œโ”€โ”€ app/
โ”‚   โ””โ”€โ”€ page.tsx / page.jsx       # Home page (static UI)
โ”œโ”€โ”€ next.config.js                # Static export config
โ””โ”€โ”€ README.md                     # This file

๐Ÿ“ฆ Data Format

states-cities.json

[
  {
    "state": "Maharashtra",
    "code": "MH",
    "cities": ["Mumbai", "Pune", "Nagpur"]
  },
  {
    "state": "Karnataka",
    "code": "KA",
    "cities": ["Bengaluru", "Mysuru"]
  }
]

More data will be added over time or contributed by the community.


๐Ÿš€ Getting Started (Locally)

  1. Clone this repo

    git clone https://github.com/vipinwap07/indian-atlas.git
    cd indian-atlas
    
  2. Install dependencies

    npm install
    
  3. Start local dev server

    npm run dev
    
  4. Export static site

    npm run deploy
    

๐Ÿ“š Use Cases


๐Ÿค Contributing

Want to help? Hereโ€™s how:

Feel free to fork and open a pull request!


๐Ÿ“„ License

MIT ยฉ Vipin Kumar โ€” Free to use and modify.