{"id":27700928,"url":"https://github.com/raiolanetworks/atlas","last_synced_at":"2026-02-06T11:23:24.496Z","repository":{"id":228532520,"uuid":"774258788","full_name":"RaiolaNetworks/atlas","owner":"RaiolaNetworks","description":"Atlas is a PHP package that allows you to create new tables in your database and populate them with information about regions, subregions, countries, states, cities, time zones, and more.","archived":false,"fork":false,"pushed_at":"2025-03-20T10:48:23.000Z","size":5712,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-25T19:11:49.951Z","etag":null,"topics":["cities","countries","country-list","laravel","laravel-framework","laravel-package","php","php8","states"],"latest_commit_sha":null,"homepage":"https://packagist.org/packages/raiolanetworks/atlas","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RaiolaNetworks.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"vendor_name"}},"created_at":"2024-03-19T08:24:45.000Z","updated_at":"2025-03-20T10:48:02.000Z","dependencies_parsed_at":"2024-12-20T18:28:16.472Z","dependency_job_id":"698e487c-36c9-4e0a-b11c-d1d4dfec28e0","html_url":"https://github.com/RaiolaNetworks/atlas","commit_stats":null,"previous_names":["raiolanetworks/atlas"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RaiolaNetworks%2Fatlas","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RaiolaNetworks%2Fatlas/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RaiolaNetworks%2Fatlas/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RaiolaNetworks%2Fatlas/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RaiolaNetworks","download_url":"https://codeload.github.com/RaiolaNetworks/atlas/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250878891,"owners_count":21501743,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cities","countries","country-list","laravel","laravel-framework","laravel-package","php","php8","states"],"created_at":"2025-04-25T19:11:57.601Z","updated_at":"2026-02-06T11:23:24.482Z","avatar_url":"https://github.com/RaiolaNetworks.png","language":"PHP","funding_links":["https://github.com/sponsors/vendor_name"],"categories":[],"sub_categories":[],"readme":"# Get the data from the most recondite place with 'Atlas'\n\n[![Latest Version on Packagist](https://img.shields.io/packagist/v/raiolanetworks/atlas.svg?style=flat-square)](https://packagist.org/packages/raiolanetworks/atlas)\n[![GitHub Tests Action Status](https://img.shields.io/github/actions/workflow/status/raiolanetworks/atlas/tests.yml?branch=main\u0026label=tests\u0026style=flat-square)](https://github.com/raiolanetworks/atlas/actions?query=workflow%3ATests+branch%3Amain)\n[![GitHub Code Style Action Status](https://img.shields.io/github/actions/workflow/status/raiolanetworks/atlas/pint.yml?branch=main\u0026label=code%20style\u0026style=flat-square)](https://github.com/raiolanetworks/atlas/actions?query=workflow%3APint+branch%3Amain)\n[![Total Downloads](https://img.shields.io/packagist/dt/raiolanetworks/atlas.svg?style=flat-square)](https://packagist.org/packages/raiolanetworks/atlas)\n\nWith 'Atlas' you will be able to create new tables in the database and fill them with information about countries, states, cities, timezones and more.\n\n## Requirements\n\n- PHP 8.3+\n- Laravel 11+\n\n\n## Get to know us\n\n[\u003cimg src=\"https://cdn-assets.raiolanetworks.com/dist/images/logos/logo-blue.svg\" width=\"419px\" /\u003e](https://raiolanetworks.com)\n\n\n## Installation\n\nInstall the package via Composer:\n```bash\ncomposer require raiolanetworks/atlas\n```\n\nOptionally publish the config file to customise table names or toggle entities:\n```bash\nphp artisan vendor:publish --tag=\"atlas-config\"\n```\n\nRun the migrations and seed the database:\n```bash\nphp artisan atlas:install\n```\n\nThe command will migrate the tables for every entity enabled in `config('atlas.entities')` (all enabled by default) and let you choose which seeders to run. The process may take a few minutes due to the large number of cities.\n\nTo re-seed the data after a package upgrade:\n```bash\nphp artisan atlas:update\n```\n\n### Other publishable resources\n\n```bash\nphp artisan vendor:publish --tag=\"atlas-translations\"\nphp artisan vendor:publish --tag=\"atlas-jsons\"        # JSON data files (for overriding)\n```\n\n\u003e **Note:** Migrations are auto-loaded by the package. Do **not** publish them with `--tag=\"atlas-migrations\"` unless you have a specific reason — published copies will cause \"table already exists\" errors.\n\n\n## Usage\n\nInternally, the package works with Laravel models, which allows you to work with this model as if they were models of your own project.\n\nFor example, if you want to get all the countries in Africa:\n\n```php\nuse Raiolanetworks\\Atlas\\Models\\Country;\n\nclass MyClass\n{\n\tpublic function getAllAfricaCountries(): Collection\n\t{\n\t\treturn Country::where('region_name', 'Africa')\n\t\t\t-\u003eorderBy('name')\n\t\t\t-\u003eget();\n\t}\n}\n\n```\n\n\n## Upgrading\n\nIf you are upgrading from 1.x, please see [UPGRADE.md](./UPGRADE.md) for a list of breaking changes and migration steps.\n\n## Changelog\n\nPlease see [CHANGELOG](./CHANGELOG.md) for more information on what has changed recently.\n\n\n## Credits\n\n- [Martín Gómez](https://github.com/soymgomez)\n- [Víctor Escribano](https://github.com/victore13)\n\n\n## License\n\nThe MIT License (MIT). Please see [License File](LICENSE.md) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraiolanetworks%2Fatlas","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraiolanetworks%2Fatlas","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraiolanetworks%2Fatlas/lists"}