# rinvex/countries

Rinvex Country is a simple and lightweight package for retrieving country details with flexibility. A whole bunch of data including name, demonym, capital, iso codes, dialling codes, geo data, currencies, flags, emoji, and other attributes for all 250 countries worldwide at your fingertips.

Repository: https://github.com/rinvex/countries
Canonical: https://ross.abutalabs.com/products/rinvex-countries
Homepage: https://rinvex.com
Language: PHP
License: MIT
License Family: permissive
Topics: php, countries, capitals, flags
Last push: 2025-07-15T12:06:49+00:00

## Health v2 (maintenance only)
Score: 46/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 31, release rhythm 35, longevity 100
- inputs: {"age_days": 3667, "days_push": 414, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1747, forks 214 (observed 2026-08-28T04:05:30.793891+00:00)

## What it is
A lightweight, framework-agnostic PHP library providing detailed data for all 250 countries worldwide, including names, capitals, ISO codes, dialling codes, geo data, currencies, flags, and emoji. It offers flexible retrieval and filtering of country attributes with zero dependencies beyond PHP itself.

## Use cases
- get country details by ISO code in PHP
- populate country dropdown lists with names and flags
- look up dialling codes and currencies for countries
- filter countries by continent or other attributes
- get country emoji and flag images
- retrieve country borders, area, and geo data
- build international forms with country data

## When to choose
- you need comprehensive country data in a PHP project
- you want a dependency-free, framework-agnostic solution
- you need filtering and querying over country datasets
- you need flags, emoji, currencies, and geo data in one package

## When to avoid
- you need frequently updated geopolitical data beyond the shipped dataset
- your project is not in PHP
- you only need a small subset like country names, where a simpler list suffices

## Facets
- artifact type: library
- maturity: stable
- function: sdk, developer-tools
- domain: developer-tools, web-development
- platform: php
- tags: countries, iso-3166, country-data, flags, emoji, currencies, dialling-codes, framework-agnostic, localization

## Member repositories
- rinvex/countries (main) score 46

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:30.793891+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:29:10.455496+00:00, confidence not recorded.
  - readme: https://github.com/rinvex/countries (fetched 2026-08-28T04:05:30.793891+00:00, sha ca033f55f2c6)
  - homepage: https://rinvex.com (fetched 2026-08-29T11:06:55.573805+00:00, sha bb02578cfb32)
  - site_page: https://rinvex.com/about.html (fetched 2026-08-29T11:06:55.577011+00:00, sha 996544252041)
- Data as of 2026-08-30T08:39:29.467469+00:00.
