awcodes/postal-codes

This is a package to easily install and use postal codes in your Laravel application from GeoNames.org
4,690 5
Install
composer require awcodes/postal-codes
Latest Version:v1.0.2
PHP:^8.3
License:MIT
Last Updated:Sep 9, 2026
Links: GitHub  ·  Packagist
Maintainer: awcodes

This is my package postal-codes

Latest Version on Packagist Total Downloads

This is a package to easily install and use postal codes in your Laravel application. All data is provided by GeoNames data dumps. You can see the available countries at https://download.geonames.org/export/zip/.

Installation & Usage

You can install the package via composer:

composer require awcodes/postal-codes

If you need to publish the migration you may do so with:

php artisan postal-codes:install

Then the only thing left to do is to seed your data. This can be done with the postal-codes:seed command.

php artisan postal-codes:seed {country=US}

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Development

Install dependencies:

composer install

Run the test suite:

composer test

Start the Workbench application:

composer serve

The Workbench is available at http://localhost:8000 with a small local postal-code dataset. It does not download data from GeoNames unless you explicitly run the seed command.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.

Related Packages

awcodes/filament-badgeable-column

Filament Tables column to append and prepend badges.

689,428 148
awcodes/filament-quick-create

Plugin for Filament Admin that adds a dropdown menu to the header to quickly cre...

259,020 251
awcodes/filament-table-repeater

A modified version of the Filament Forms Repeater to display it as a table.

980,957 267
awcodes/filament-curator

A media picker plugin for FilamentPHP.

442,682 443
awcodes/filament-versions

A mostly useless package to display framework versions at the bottom of the navi...

81,003 44