PHPackages                             roshan-dhungana/nepal-geography - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. roshan-dhungana/nepal-geography

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

roshan-dhungana/nepal-geography
===============================

Reusable Nepal provinces, districts and municipalities dataset for Laravel

v1.2.4(1mo ago)139↓36.8%MITPHPPHP ^8.2

Since Mar 30Pushed 2mo agoCompare

[ Source](https://github.com/dhunganaroshan341/NepalGeographyComposerLaravel)[ Packagist](https://packagist.org/packages/roshan-dhungana/nepal-geography)[ Docs](https://github.com/dhunganaroshan341/NepalGeographyComposerLaravel)[ RSS](/packages/roshan-dhungana-nepal-geography/feed)WikiDiscussions main Synced 5d ago

READMEChangelogDependencies (4)Versions (16)Used By (0)

Nepal Geography for Laravel 🇳🇵
==============================

[](#nepal-geography-for-laravel-)

A Laravel package providing Nepal's complete administrative geography dataset, including provinces, districts, municipalities, cities, and wards.

Features
--------

[](#features)

- 🇳🇵 Nepal country dataset
- 🏔️ 7 Provinces
- 🗺️ 77 Districts
- 🏘️ Municipalities and Rural Municipalities
- 🏙️ Cities
- 🏠 Wards
- Eloquent-ready database structure
- Automated installation command
- Supports Laravel 10, 11, and 12
- Supports PHP 8.2+

---

Installation
------------

[](#installation)

Install the package via Composer:

```
composer require roshan-dhungana/nepal-geography
```

---

Setup
-----

[](#setup)

Run the installation command:

```
php artisan nepal:install
```

The installer will automatically:

1. Publish Nepal geography JSON data
2. Run package migrations
3. Seed Nepal geography records

---

Fresh Installation
------------------

[](#fresh-installation)

To completely rebuild your database:

```
php artisan nepal:install --fresh
```

Or skip confirmation:

```
php artisan nepal:install --fresh --force
```

⚠️ Warning:

```
This command will delete all existing database tables and recreate them.

```

The installer will:

1. Publish Nepal geography JSON data
2. Run migrate:fresh
3. Recreate all tables
4. Seed Nepal geography data

---

Database Structure
------------------

[](#database-structure)

```
Country
 └── Province
      └── District
           └── Municipality
                └── City
                     └── Ward

```

---

Example Usage
-------------

[](#example-usage)

### Provinces

[](#provinces)

```
use RoshanDhungana\NepalGeography\Models\State;

$province = State::first();
```

### Districts of a Province

[](#districts-of-a-province)

```
$districts = $province->districts;
```

### Municipality

[](#municipality)

```
$municipality = Municipality::first();

$district = $municipality->district;
```

### Province from District

[](#province-from-district)

```
$province = $district->state;
```

---

Available Commands
------------------

[](#available-commands)

### Install

[](#install)

```
php artisan nepal:install
```

### Fresh Install

[](#fresh-install)

```
php artisan nepal:install --fresh
```

### Skip Confirmation

[](#skip-confirmation)

```
php artisan nepal:install --fresh --force
```

---

Supported Versions
------------------

[](#supported-versions)

PackageSupportPHP8.2+Laravel10.xLaravel11.xLaravel12.x---

License
-------

[](#license)

MIT License

---

Author
------

[](#author)

Roshan Dhungana

GitHub:

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance86

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~6 days

Recently: every ~0 days

Total

15

Last Release

54d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ab2d1e60fe97cb6b3b5413231ef100337cb8c90831502c9b6827ff2271c474b4?d=identicon)[dhunganaroshan341](/maintainers/dhunganaroshan341)

---

Top Contributors

[![dhunganaroshan341](https://avatars.githubusercontent.com/u/79978683?v=4)](https://github.com/dhunganaroshan341 "dhunganaroshan341 (15 commits)")

---

Tags

laravelgeographynepalprovincesdistrictsmunicipalitieswards

### Embed Badge

![Health badge](/badges/roshan-dhungana-nepal-geography/health.svg)

```
[![Health](https://phpackages.com/badges/roshan-dhungana-nepal-geography/health.svg)](https://phpackages.com/packages/roshan-dhungana-nepal-geography)
```

###  Alternatives

[renatomarinho/laravel-page-speed

Laravel Page Speed

2.5k1.7M11](/packages/renatomarinho-laravel-page-speed)[emargareten/inertia-modal

Inertia Modal is a Laravel package that lets you implement backend-driven modal dialogs for Inertia apps.

90157.6k](/packages/emargareten-inertia-modal)[forjedio/inertia-table

Backend-driven dynamic tables for Laravel + Inertia.js

272.0k](/packages/forjedio-inertia-table)[tomshaw/electricgrid

A feature-rich Livewire package designed for projects that require dynamic, interactive data tables.

119.8k](/packages/tomshaw-electricgrid)[plin-code/laravel-istat-geography

Laravel package for importing and managing Italian geography data from ISTAT

107.7k1](/packages/plin-code-laravel-istat-geography)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
