# antonioribeiro/countries

Laravel countries and currencies

Repository: https://github.com/antonioribeiro/countries
Canonical: https://ross.abutalabs.com/products/antonioribeiro-countries
Language: PHP
License: BSD-3-Clause
License Family: permissive
Topics: laravel, laravel-countries, countries, languages, timezones, states, php, hacktoberfest-accepted
Last push: 2026-03-29T12:07:34+00:00

## Health v2 (maintenance only)
Score: 69/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 74, release rhythm 45, longevity 100
- inputs: {"age_days": 3496, "days_push": 157, "days_rel": 157, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1933, forks 300 (observed 2026-08-28T04:05:56.333222+00:00)

## What it is
A PHP/Laravel package providing comprehensive reference data about countries, including currencies, timezones, states, cities, borders, flags, taxes, and geographic maps. It exposes this data through Laravel Collections and is compatible with Laravel 10, 11, and 12 on PHP 8.1+.

## Use cases
- get a list of all countries with codes in php
- look up currency for a country in laravel
- populate a country and state dropdown
- find timezones for each country
- get country borders and flag data
- map country coordinates for plotting on a map
- list cities and states by country

## When to choose
- you need static country, currency, timezone, or geographic reference data in a PHP or Laravel project
- you want a single dependency covering countries, states, cities, flags, and maps
- you prefer data accessible via Laravel Collections without a database

## When to avoid
- you need live or frequently updated geopolitical data
- you need full city-level coverage beyond the ~7k cities included
- you are not using PHP or a framework outside the Laravel ecosystem

## Facets
- artifact type: library
- maturity: active
- function: sdk
- domain: developer-tools
- platform: php
- tags: laravel, countries, currencies, timezones, states, cities, flags, php-package, reference-data, localization, geospatial

## Member repositories
- antonioribeiro/countries (main) score 69

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:56.333222+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:08:33.853737+00:00, confidence not recorded.
  - readme: https://github.com/antonioribeiro/countries (fetched 2026-08-28T04:05:56.333222+00:00, sha 3ef847459a8f)
- Data as of 2026-08-30T08:39:29.467469+00:00.