PHPackages                             harrym/indonesian-regions - 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. [Database & ORM](/categories/database)
4. /
5. harrym/indonesian-regions

ActiveLibrary[Database & ORM](/categories/database)

harrym/indonesian-regions
=========================

Indonesian Region Database for Laravel

2.0.0(4mo ago)071↓91.7%MITPHPPHP ^8.2CI passing

Since Aug 13Pushed 4mo agoCompare

[ Source](https://github.com/harrymahardhika/indonesian-regions)[ Packagist](https://packagist.org/packages/harrym/indonesian-regions)[ Docs](https://github.com/concatenate/indonesian-regions)[ RSS](/packages/harrym-indonesian-regions/feed)WikiDiscussions main Synced 4d ago

READMEChangelogDependencies (10)Versions (8)Used By (0)

Indonesian Regions
==================

[](#indonesian-regions)

[![Latest Version on Packagist](https://camo.githubusercontent.com/200c5be72c9f9454ccbf7689e5f8b9c065feebe3d9bb770158305a364c212ef5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f68617272796d2f696e646f6e657369616e2d726567696f6e732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/harrym/indonesian-regions)[![Total Downloads](https://camo.githubusercontent.com/300a4bf9d2d39697b5844f7b003424e6d2e8a692a34ad77a12a385c0f4ad8b27/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f68617272796d2f696e646f6e657369616e2d726567696f6e732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/harrym/indonesian-regions)[![License](https://camo.githubusercontent.com/3645edfba9cd6086b1bd5d2caec839f6fb26c4044e633d9278f464afefbe987b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f68617272796d2f696e646f6e657369616e2d726567696f6e732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/harrym/indonesian-regions)

A fast, lightweight, and modern Indonesian Region Database (Provinsi, Kota/Kabupaten, Kecamatan, Kelurahan/Desa) package for Laravel.

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

[](#installation)

You can install the package via composer:

```
composer require harrym/indonesian-regions
```

After installation, publish the database migrations and configuration:

```
php artisan vendor:publish --provider="HarryM\IndonesianRegions\IndonesianRegionsServiceProvider"
```

Then run the migrations to create the required tables:

```
php artisan migrate
```

Finally, seed the regions database (this process handles bulk upserts securely and efficiently):

```
php artisan db:seed --class="HarryM\IndonesianRegions\Database\Seeders\RegionSeeder"
```

Structure
---------

[](#structure)

The provided datasets contain data mapped into four levels of regions:

- `AreaProvince` (Provinces)
- `AreaCity` (Cities & Regencies / Kota & Kabupaten)
- `AreaDistrict` (Districts / Kecamatan)
- `AreaSubdistrict` (Subdistricts & Villages / Kelurahan & Desa)

Usage
-----

[](#usage)

All Area models use Laravel's standard Eloquent system. You can interact with them statically or via relationships:

```
use HarryM\IndonesianRegions\Models\AreaProvince;
use HarryM\IndonesianRegions\Models\AreaCity;

// Get all provinces
$provinces = AreaProvince::all();

// Get the cities of a specific province using relationship
$province = AreaProvince::where('name', 'DKI JAKARTA')->first();
$jakartaCities = $province->cities;

// Get the district associated with a city
$city = AreaCity::where('name', 'KOTA JAKARTA SELATAN')->first();
$districts = $city->districts;

// Get subdistricts of a specific district
$district = $city->districts()->first();
$subdistricts = $district->subdistricts;
```

Testing
-------

[](#testing)

```
composer test
```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance75

Regular maintenance activity

Popularity8

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity69

Established project with proven stability

 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 ~275 days

Recently: every ~371 days

Total

7

Last Release

134d ago

Major Versions

1.3.1 → 2.0.02026-02-21

PHP version history (4 changes)1.0.0PHP ^7.4

1.1.0PHP ^7.4|^8.0

1.3.0PHP ^8.0|^8.1

2.0.0PHP ^8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/60742?v=4)[harrym](/maintainers/harrym)[@harrym](https://github.com/harrym)

---

Top Contributors

[![harrymahardhika](https://avatars.githubusercontent.com/u/81987?v=4)](https://github.com/harrymahardhika "harrymahardhika (26 commits)")

---

Tags

laravelindonesian-regions

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/harrym-indonesian-regions/health.svg)

```
[![Health](https://phpackages.com/badges/harrym-indonesian-regions/health.svg)](https://phpackages.com/packages/harrym-indonesian-regions)
```

###  Alternatives

[relaticle/custom-fields

User Defined Custom Fields for Laravel Filament

16354.2k](/packages/relaticle-custom-fields)[dragon-code/laravel-deploy-operations

Performing any actions during the deployment process

244226.1k2](/packages/dragon-code-laravel-deploy-operations)[sebdesign/laravel-viva-payments

A Laravel package for integrating the Viva Payments gateway

4851.0k](/packages/sebdesign-laravel-viva-payments)[telkins/laravel-dag-manager

A SQL-based Directed Acyclic Graph (DAG) solution for Laravel.

335.2k](/packages/telkins-laravel-dag-manager)[helgesverre/chromadb

PHP Client for the Chromadb Rest API

321.5k](/packages/helgesverre-chromadb)[helgesverre/milvus

PHP Client for the Milvus Rest API

327.2k](/packages/helgesverre-milvus)

PHPackages © 2026

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