PHPackages                             vernsg/nusa-filament - 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. [Admin Panels](/categories/admin)
4. /
5. vernsg/nusa-filament

ActiveLibrary[Admin Panels](/categories/admin)

vernsg/nusa-filament
====================

Ready-to-use Filament 4 components for creasi/laravel-nusa Indonesian administrative regions.

v0.1.4(1mo ago)10MITPHPPHP ^8.2CI failing

Since May 27Pushed 1mo agoCompare

[ Source](https://github.com/VernSG/nusa-filament)[ Packagist](https://packagist.org/packages/vernsg/nusa-filament)[ Docs](https://github.com/vernsg/nusa-filament)[ RSS](/packages/vernsg-nusa-filament/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (27)Versions (6)Used By (0)

Nusa Filament
=============

[](#nusa-filament)

[![CI](https://github.com/VernSG/nusa-filament/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/VernSG/nusa-filament/actions/workflows/ci.yml?query=branch%3Amain)[![Latest Version on Packagist](https://camo.githubusercontent.com/9bf0f4f7d1ddfd2725dd18cd00b7d2b80d0820f7bb5b499d9dfe8da631f8ed81/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7665726e73672f6e7573612d66696c616d656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/vernsg/nusa-filament)[![Total Downloads](https://camo.githubusercontent.com/8bb02c343e2dc23f3fc5100788d4528c479530206e97320c4f81c458fbbbf804/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7665726e73672f6e7573612d66696c616d656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/vernsg/nusa-filament)[![License](https://camo.githubusercontent.com/b924949e940a883a15605d6720f361777886401a495b3a223ac062e82ea6e495/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f7665726e73672f6e7573612d66696c616d656e742e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)

Nusa Filament provides Filament 4 components for working with Indonesian administrative regions in Laravel applications. It is powered by [`creasi/laravel-nusa`](https://github.com/creasico/laravel-nusa), which supplies the underlying region data and lookup support.

Use this package to add cascading **Provinsi -> Kabupaten/Kota -> Kecamatan -> Desa/Kelurahan** selects to Filament forms. It also includes postal code autofill, table columns, filters, infolist entries, and validation rules for applications that store Indonesian address data.

Preview
-------

[](#preview)

[![Nusa Filament](docs/images/preview.jpg)](docs/images/preview.jpg)

Child regions are displayed as soon as a parent region is selected. Remote search remains available for filtering larger option lists.

Features
--------

[](#features)

- **Form components:** cascading province, regency, district, and village selects, available individually or as a complete address group with sensible default field names.
- **Dependent options:** child regions are loaded immediately after their parent region is selected, with remote search for larger option lists.
- **Postal code autofill:** the postal code field can be filled automatically from the selected village.
- **Display components:** table columns and infolist entries resolve stored region codes to readable names.
- **Table filtering:** a dependent location filter supports province, regency, district, and village fields.
- **Validation:** Laravel validation rules check individual region codes and address hierarchy consistency.
- **Configuration:** field names, labels, search limit, native select behavior, and dropdown position can be customized.

Requirements
------------

[](#requirements)

Package VersionPHPLaravelFilament`^0.1``^8.2``^11.0 | ^12.0``^4.0`The PHP `sqlite3` extension is also required. Laravel Nusa stores its administrative region dataset in SQLite, so the extension must be enabled in the application that installs this package.

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

[](#installation)

Install the package with Composer:

```
composer require vernsg/nusa-filament
```

Laravel package auto-discovery registers the service provider automatically.

Publish the configuration file if you need to customize field names, labels, the search limit, native select behavior, or dropdown position:

```
php artisan vendor:publish --tag=nusa-filament-config
```

The published configuration file will be available at:

```
config/nusa-filament.php

```

Usage
-----

[](#usage)

### Quick Start

[](#quick-start)

Add `NusaAddress` to a Filament resource form to render a complete Indonesian address block.

```