Tlotlo-pat/botswana-locations

# 🇧🇼 Botswana Locations **A lightweight NPM package for finding Botswana locations and their districts.** `botswana-locations` provides a simple, fast, and developer-friendly way to look up Botswana locations and determine the district associated with each location. It is designed for developers building web applications, mobile applications, APIs, dashboards, delivery platforms, e-commerce systems, registration forms, and other software that needs Botswana location data. The package works locally and does not require an external API, database, API key, or internet connection for location lookups. --- ## 📦 Installation Install with NPM: ```bash npm install botswana-locations ``` Using Yarn: ```bash yarn add botswana-locations ``` Using pnpm: ```bash pnpm add botswana-locations ``` --- # 🚀 Quick Start Import the functions you need: ```js const { getDistrict, findLocation, searchLocations, getLocations, } = require("botswana-locations"); ``` Find the district of a location: ```js const district = getDistrict("Gaborone"); console.log(district); ``` Output: ```text Gaborone ``` That's all that is required to perform a location-to-district lookup. --- # ✨ Features - 🇧🇼 Botswana-focused location dataset - 📍 Location-to-district lookup - 🔎 Location searching - 🔤 Case-insensitive lookups - 🔍 Partial text searching - ⚡ Fast local lookups - 📴 Offline-friendly - 🌐 No external API required - 🔑 No API key required - 💾 No database required - 📦 Lightweight - 🧩 Simple JavaScript API - ⚛️ React compatible - 📱 React Native compatible - 🚀 Expo compatible - 🖥️ Node.js compatible - 🌐 Express.js compatible - ⚡ Next.js compatible - 🛠️ Vite compatible --- # 🎯 What Does This Package Do? The main purpose of the package is simple: ```text Location → District ``` For example: ```js getDistrict("Gaborone"); ``` returns: ```text Gaborone ``` You can also retrieve the complete location record: ```js findLocation("Gaborone"); ``` which returns: ```js { name: "G …