PHPackages                             creasi/laravel-nusa - 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. creasi/laravel-nusa

ActiveLibrary

creasi/laravel-nusa
===================

A Laravel package that aim to provide Indonesia' Administrative Data

v0.1.16(5mo ago)987.2k↓37.1%18[12 PRs](https://github.com/creasico/laravel-nusa/pulls)1MITPHPPHP ^8.2CI passing

Since Jun 23Pushed 2mo ago6 watchersCompare

[ Source](https://github.com/creasico/laravel-nusa)[ Packagist](https://packagist.org/packages/creasi/laravel-nusa)[ GitHub Sponsors](https://github.com/sponsors/creasico)[ RSS](/packages/creasi-laravel-nusa/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (7)Versions (39)Used By (1)

Laravel Nusa
============

[](#laravel-nusa)

[![Version](https://camo.githubusercontent.com/de813c635bd57ac92064ece2ec12285f2f76d2966634a19e60eb009b501c8b01/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6372656173692f6c61726176656c2d6e7573613f7374796c653d666c61742d737175617265)](https://packagist.org/packages/creasi/laravel-nusa)[![License](https://camo.githubusercontent.com/c4a38c449d28010becfcedc2cb0a2de070493fd7a68ae3d9ba468fb87a6ccb11/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f637265617369636f2f6c61726176656c2d6e7573613f7374796c653d666c61742d737175617265)](https://github.com/creasico/laravel-nusa/blob/main/LICENSE)[![Actions Status](https://camo.githubusercontent.com/ec238dcdabecbfbcceea9ed7ed3d3b0738ebd5e8c85b58b6e2f07ea1b8c0ec9b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f637265617369636f2f6c61726176656c2d6e7573612f74657374732e796d6c3f6272616e63683d6d61696e267374796c653d666c61742d737175617265)](https://github.com/creasico/laravel-nusa/actions)[![Total Downloads](https://camo.githubusercontent.com/ace42f20bf705cbb4e825d580153184230ee90ebc6998e5ae9d0203d49859dec/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6372656173692f6c61726176656c2d6e7573612e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/creasi/laravel-nusa)

Laravel Nusa provides complete, ready-to-use Indonesian administrative region data for Laravel applications. This package includes all **38** provinces, **514** regencies, **7,285** districts, and **83,762** villages with their hierarchical relationships, postal codes, and geographic coordinates based on **Kepmendagri No 300.2.2-2138 Tahun 2025**.

Laravel Nusa solves the common challenge of integrating Indonesian administrative data into Laravel applications. Unlike other packages, it requires no data migration or seeding—the data is ready immediately after installation.

### What's Included

[](#whats-included)

Instead of manually importing and maintaining large datasets, you get:

- **Instant Setup**: Pre-packaged SQLite database with all data ready to use
- **Official Data**: Sourced from authoritative Indonesian government databases
- **Complete Models**: Province, Regency, District, Village with relationships
- **RESTful API**: Ready-to-use endpoints for all administrative levels
- **Address Management**: Built-in address system with validation
- **Geographic Data**: Coordinates and postal codes
- **Customizable**: Extend models and customize to fit your needs

Documentation
-------------

[](#documentation)

For complete usage instructions, API reference, examples, and guides, visit our comprehensive documentation:

**📚 [Laravel Nusa Documentation](https://nusa.creasi.dev/)**

### Quick Start

[](#quick-start)

Install the package via Composer:

```
composer require creasi/laravel-nusa
```

Start using it immediately:

```
use Creasi\Nusa\Models\Province;

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

// Search by name or code
$jateng = Province::search('Jawa Tengah')->first();
$jateng = Province::search('33')->first();

// Get related data
$regencies = $jateng->regencies;
$districts = $jateng->districts;
$villages = $jateng->villages;
```

That's all! The package is ready to use immediately after installation.

Contributing
------------

[](#contributing)

For development setup, contribution guidelines, and detailed information about the project structure, see the [full documentation](https://nusa.creasi.dev/en/guide/development).

Credits
-------

[](#credits)

- [cahyadsn/wilayah](https://github.com/cahyadsn/wilayah) [![License](https://camo.githubusercontent.com/1582777946265a85216f44070540b354cd91aba1f7c07d6e2492eff0650c257c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f636168796164736e2f77696c617961683f7374796c653d666c61742d737175617265)](https://github.com/cahyadsn/wilayah/blob/master/LICENSE)
- [cahyadsn/wilayah\_kodepos](https://github.com/cahyadsn/wilayah_kodepos) [![License](https://camo.githubusercontent.com/543f7d46286080d7aa89a35f5be9b767737d6d6f680261f21b94e9e482a0a016/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f636168796164736e2f77696c617961685f6b6f6465706f733f7374796c653d666c61742d737175617265)](https://github.com/cahyadsn/wilayah_kodepos/blob/master/LICENSE)
- [cahyadsn/wilayah\_boundaries](https://github.com/cahyadsn/wilayah_boundaries) [![License](https://camo.githubusercontent.com/4c3f2a174870ac164d796ed15347eaea916836ceab9fb66fd71c268c66d1a242/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f636168796164736e2f77696c617961685f626f756e6461726965733f7374796c653d666c61742d737175617265)](https://github.com/cahyadsn/wilayah_boundaries/blob/master/LICENSE)
- [w3appdev/kodepos](https://github.com/w3appdev/kodepos)
- [edwardsamuel/Wilayah-Administratif-Indonesia](https://github.com/edwardsamuel/Wilayah-Administratif-Indonesia) [![License](https://camo.githubusercontent.com/cbcd046d49003abda1ab74a143291bd6d135aa7bcda9f03459c2ddd36e7a1cc8/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f65647761726473616d75656c2f57696c617961682d41646d696e69737472617469662d496e646f6e657369613f7374796c653d666c61742d737175617265)](https://github.com/edwardsamuel/Wilayah-Administratif-Indonesia/blob/master/license.md)

License
-------

[](#license)

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

###  Health Score

53

—

FairBetter than 97% of packages

Maintenance80

Actively maintained with recent releases

Popularity40

Moderate usage in the ecosystem

Community22

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 78.2% 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 ~40 days

Recently: every ~65 days

Total

23

Last Release

170d ago

PHP version history (2 changes)v0.0.1PHP ^8.1

v0.1.12PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/16384dbbd6cd66f33f13f5bf2dc7f26125049762c7414eb0e755c630375240ba?d=identicon)[feryardiant](/maintainers/feryardiant)

---

Top Contributors

[![feryardiant](https://avatars.githubusercontent.com/u/508665?v=4)](https://github.com/feryardiant "feryardiant (539 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (129 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (11 commits)")[![fihriaziz](https://avatars.githubusercontent.com/u/11206650?v=4)](https://github.com/fihriaziz "fihriaziz (4 commits)")[![creasi](https://avatars.githubusercontent.com/u/11495172?v=4)](https://github.com/creasi "creasi (3 commits)")[![oinpentuls](https://avatars.githubusercontent.com/u/39396616?v=4)](https://github.com/oinpentuls "oinpentuls (3 commits)")

---

Tags

indonesialaravel-packagelaravelpackageindonesiaprovinsikabupatenkecamatankelurahankotadesa

###  Code Quality

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/creasi-laravel-nusa/health.svg)

```
[![Health](https://phpackages.com/badges/creasi-laravel-nusa/health.svg)](https://phpackages.com/packages/creasi-laravel-nusa)
```

###  Alternatives

[laravolt/indonesia

Package Laravel yang berisi data Provinsi, Kabupaten/Kota, Kecamatan, dan Keluarahan/Desa di seluruh Indonesia.

656189.8k1](/packages/laravolt-indonesia)[lab404/laravel-impersonate

Laravel Impersonate is a plugin that allows to you to authenticate as your users.

2.3k16.4M48](/packages/lab404-laravel-impersonate)

PHPackages © 2026

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