creasi / laravel-nusa
A Laravel package that aim to provide Indonesia' Administrative Data
Fund package maintenance!
creasico
Installs: 6 052
Dependents: 2
Suggesters: 0
Security: 0
Stars: 15
Watchers: 6
Forks: 4
Open Issues: 0
Requires
- php: ^8.2
- ext-sqlite3: *
- laravel/framework: ^9.0|^10.0|^11.0|^12.0
Requires (Dev)
- composer-runtime-api: *
- laravel/pint: ^1.1
- nunomaduro/collision: ^7.4|^8.0
- orchestra/testbench: ^8.5|^9.0|^10.0
- phpmyadmin/sql-parser: ^5.11
- spatie/fork: ^1.2
- dev-main
- v0.1.14
- v0.1.13
- v0.1.12
- v0.1.11
- v0.1.10
- v0.1.9
- v0.1.8
- v0.1.7
- v0.1.6
- v0.1.5
- v0.1.4
- v0.1.3
- v0.1.2
- v0.1.1
- v0.1.0
- v0.0.6
- v0.0.5
- v0.0.4
- v0.0.3
- v0.0.2
- v0.0.1
- dev-docs/patch
- dev-docs/vitepress
- dev-fix/import-stats
- dev-dependabot/submodules/workbench/submodules/cahyadsn-wilayah_boundaries-be7b869
- dev-dependabot/submodules/workbench/submodules/cahyadsn-wilayah-edd5a45
- dev-refactor/stat-command
This package is auto-updated.
Last update: 2025-07-11 06:38:49 UTC
README
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.
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
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
For complete usage instructions, API reference, examples, and guides, visit our comprehensive documentation:
📚 Laravel Nusa Documentation
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
For development setup, contribution guidelines, and detailed information about the project structure, see the full documentation.
Credits
- cahyadsn/wilayah
- cahyadsn/wilayah_kodepos
- cahyadsn/wilayah_boundaries
- w3appdev/kodepos
- edwardsamuel/Wilayah-Administratif-Indonesia
License
The MIT License (MIT). Please see License File for more information.