artessan-devs/terra

Comprehensive world geodata package for Laravel including countries, states, cities, currencies, translations, and geographic references.

dev-development 2026-05-23 10:44 UTC

Requires

• php: ^8.4
• illuminate/contracts: ^11.0||^12.0||^13.0
• kdabrow/seeder-once: ^6.0
• spatie/laravel-package-tools: ^1.16
• spatie/laravel-translatable: ^6.14

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.14
• nunomaduro/collision: ^8.8
• orchestra/testbench: ^11.0.0||^10.0.0||^9.0.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-arch: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• phpstan/extension-installer: ^1.4
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• spatie/laravel-ray: ^1.35

MIT

• J. Casanova

• laravel
• Terra
• artessan-devs

README

A Laravel package for countries, states, cities, currencies, postcodes, and timezones with multi-language support.

Data sourced from dr5hn/countries-states-cities-database.

Getting started

composer require artessan-devs/terra
php artisan vendor:publish --tag="terra-migrations"
php artisan migrate
php artisan terra:seed

$country = Country::where('iso2', 'US')->first();
echo $country->localized_name; // United States

Documentation

See the docs index for installation, usage, models, architecture, and more.

Changelog

Please see CHANGELOG for recent changes.

License

The MIT License (MIT). See LICENSE.