🇧🇩 Bangladesh Geo Data

A lightweight npm package providing Bangladesh divisions, districts, and upazilas data with simple utility functions for easy usage in JavaScript/TypeScript applications.

🚀 Features

• 🇧🇩 Complete Bangladesh geographical dataset
• 🗺️ Divisions, Districts, and Upazilas included
• ⚡ Lightweight and fast (no dependencies)
• 📦 Easy to use in Node.js, React, Next.js, TypeScript
• 🔍 Utility functions for filtering and searching data
• 🧠 Type-safe TypeScript support

📦 Installation

npm install bangladesh-geo-data

or

yarn add bangladesh-geo-data

🧩 Usage

Import the package

import {
  getAllDivisions,
  getAllDistricts,
  getAllUpazilas,
  getDivisionById,
  getDistrictsByDivision,
  getFullLocation
} from "bangladesh-geo-data";

🗺️ Divisions

const divisions = getAllDivisions();
console.log(divisions);

const dhaka = getDivisionById("div-01");
console.log(dhaka);

🏙️ Districts

const districts = getAllDistricts();

const dhakaDistricts = getDistrictsByDivision("div-01");
console.log(dhakaDistricts);

🏡 Upazilas

const upazilas = getAllUpazilas();

const dhakaUpazilas = getUpazilasByDistrict("dis-01");
console.log(dhakaUpazilas);

🌍 Full Location Lookup

const location = getFullLocation("upa-001");

console.log(location);
/*
{
  division: { ... },
  district: { ... },
  upazila: { ... }
}
*/

📊 Data Structure

Division

{
  "id": "div-01",
  "name": "Dhaka",
  "nameBn": "ঢাকা"
}

District

{
  "id": "dis-01",
  "name": "Dhaka",
  "nameBn": "ঢাকা",
  "divisionId": "div-01"
}

Upazila

{
  "id": "upa-001",
  "name": "Dhamrai",
  "nameBn": "ধামরাই",
  "districtId": "dis-01"
}

📌 Use Cases

• 📍 Location dropdowns
• 🧾 Address forms
• 🌐 Bangladesh-focused applications
• 📊 Data visualization tools
• 🏛️ Government or education systems

🪪 License

MIT © Shodorson