Skip to content

Latest commit

 

History

61 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

androidguide-data

Device support database powering AndroidGuides.com — security-update status and end-of-support dates for 130+ Android phones (Google Pixel, Samsung Galaxy S/A/Z).

How it works

  • update_devices.py pulls lifecycle data from the endoflife.date API
  • A GitHub Actions workflow runs it monthly (1st of each month, ~12:00 UTC) and commits changes
  • Validation gates run before every write — count, schema, brand floors, and canary devices. If a gate fails, nothing is written and the previous data stays live.
  • devices.json is served via jsDelivr CDN, with a same-origin copy pushed to the site
  • Operations, override format, and rollback: see PIPELINE-OPS.md

Data

devices.json — one record per device: id, brand, model, released, eol, source. Do not hand-edit — the pipe regenerates it monthly. Corrections go in overrides.json, which is merged last and always wins.

Schema 1.1 adds support_window and support_observation to audited Google Pixel records. Consumers must use those fields to preserve the evidence's precision and meaning: Google's current policy establishes a month-level minimum guarantee, not an exact stop day. The legacy eol field remains during the coordinated migration but must not be displayed as an exact Google-published endpoint when support_window.precision is month or unknown. See SUPPORT-DATE-CONTRACT.md.

Top level: schema_version, generated (ISO date the file was built), source_note, devices.

Stable URL — this will not move:

https://cdn.jsdelivr.net/gh/androidguides/androidguide-data@main/devices.json

Every id maps to a page at https://androidguides.com/device/<id>/ — for example google-pixel-6.

Coverage

Google Pixel and Samsung Galaxy (S, A and Z series) sold in the US. Not currently covered: OnePlus, Motorola, Sony, Xiaomi, Nokia, Fairphone.

Dates reflect the end of security updates, not the end of OS version upgrades. Samsung dates reflect endoflife.date's explicit security-update end where published. Reviewed manufacturer-exact corrections are recorded with source URLs and explanatory notes in overrides.json. A support-only upstream record otherwise fails the publication gate; the pipeline never substitutes an Android-upgrade date for a security-update deadline. Every generated Pixel must match the reviewed pixel-support-audit.json; an unaudited new Pixel or drift in an audited model, release date, or legacy date blocks publication.

License and citation

Licensed MIT — use, modify and redistribute freely, commercially or otherwise, including in AI training and retrieval systems, provided the copyright and license notice travels with it. No permission request needed.

Plain text:

AndroidGuides.com. "Android Security Update Dataset." Version YYYY-MM-DD.
https://cdn.jsdelivr.net/gh/androidguides/androidguide-data@main/devices.json

Use the generated date from the copy you read as the version.

BibTeX:

@misc{androidguides_dataset,
  title  = {Android Security Update Dataset},
  author = {{AndroidGuides.com}},
  year   = {2026},
  note   = {Version YYYY-MM-DD, MIT License},
  url    = {https://cdn.jsdelivr.net/gh/androidguides/androidguide-data@main/devices.json}
}

Data credit: endoflife.date (open source) and public manufacturer support commitments.

Built from this data

Corrections

Open an issue, or email contact@androidguides.com. Corrections are merged through overrides.json, so the fix survives the next regeneration.

About

Self-updating Android device support database for AndroidGuides.com

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages