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. [Utility & Helpers](/categories/utility)
4. /
5. creasi/laravel-nusa

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

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

A Laravel package that aim to provide Indonesia' Administrative Data

v0.1.18(1mo ago)997.9k↓66.9%18[6 issues](https://github.com/creasico/laravel-nusa/issues)[3 PRs](https://github.com/creasico/laravel-nusa/pulls)2MITPHPPHP ^8.2CI passing

Since Jun 23Pushed 2d ago5 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 2d ago

READMEChangelog (10)Dependencies (21)Versions (47)Used By (2)

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/7128f1f1255c18b3d7e534c729b3ab3db2c4327072ece841cecb1f2695e85eda/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f637265617369636f2f6c61726176656c2d6e7573612f6d61696e2e796d6c3f6272616e63683d6d61696e267374796c653d666c61742d737175617265)](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

### Roadmap `v0.2`

[](#roadmap-v02)

- First-party UI Implementations
    - Laravel UI [\#210](https://github.com/creasico/laravel-nusa/issues/210)
    - Filament UI [\#211](https://github.com/creasico/laravel-nusa/issues/211)
    - Flux UI [\#212](https://github.com/creasico/laravel-nusa/issues/212)
    - Inertia.js [\#213](https://github.com/creasico/laravel-nusa/issues/213)
- Provide downloadable `sqlite` database and static files on each release [\#220](https://github.com/creasico/laravel-nusa/issues/220)

### Featured Packages

[](#featured-packages)

- [`nusa-filament`](https://github.com/VernSG/nusa-filament) - Filament 4 components for Indonesian administrative region selects powered by laravel-nusa. by @VernSG

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

57

—

FairBetter than 98% of packages

Maintenance95

Actively maintained with recent releases

Popularity40

Moderate usage in the ecosystem

Community23

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 76.5% 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 ~44 days

Recently: every ~80 days

Total

25

Last Release

38d 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 (560 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (151 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.

668212.3k1](/packages/laravolt-indonesia)[markwalet/nova-modal-response

A Laravel Nova asset for Modal responses on an action.

17878.9k](/packages/markwalet-nova-modal-response)[team-nifty-gmbh/tall-datatables

Server-side rendered datatables for Laravel and Livewire

1320.9k4](/packages/team-nifty-gmbh-tall-datatables)[pdazcom/laravel-referrals

A referrals system for a laravel projects.

291.5k](/packages/pdazcom-laravel-referrals)[tomshaw/electricgrid

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

119.4k](/packages/tomshaw-electricgrid)

PHPackages © 2026

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