Open Carrier Data website

Early development. Open Carrier Data is in early development. Data, formats, tools and apps change often, and values can be wrong or missing. Don't rely on it for anything important yet. Feedback and reports are welcome.

This repository holds the one-page documentation site at https://open-carrier-data.github.io/. It is the plain-language front door for the public database at https://github.com/open-carrier-data/open-carrier-data. Carrier data does not live here, and phones never load this site at runtime.

What each file does

File	Purpose
index.html	The whole page. One h1, the early development notice, then sections from hero to contribute.
styles.css	Layout and colors. System fonts, light and dark by prefers-color-scheme.
app.js	Copy buttons only. The page works with JavaScript off.
assets/	Icon, favicon, and social preview images.
.nojekyll	Tells GitHub Pages to publish the files as they are.
.github/workflows/pages.yml	Deploys the repository root to GitHub Pages.

How the page deploys

A push to main runs .github/workflows/pages.yml, which uploads the repository root as the Pages artifact and deploys it. No build step exists.

Preview locally

To serve the page on port 8000, run this from the repository root.

python3 -m http.server

Then open http://localhost:8000/ in a browser.

Where the facts come from

Counts, file names, commands, and source terms on the page come from the public database repository at the commit named in the "Status" section. Re-check them against its README.md, SOURCES.md, generated/devices/index.json, and generated/evidence-index.json before you change a number here. Website code and text are Apache-2.0. See LICENSE.

Refresh the numbers

.github/workflows/update-numbers.yml runs every Monday at 06:00 UTC, after the private import and publish, and on dispatch. It checks out the public repository, runs python3 tools/update_numbers.py public <YYYY-MM-DD> <public-commit>, commits when a number changed, and dispatches the Pages deploy. To do it by hand, run the same command from this folder against a public checkout. It rewrites the status heading date, the quoted public commit, the profile, device, and product counts, and the status table, and fails if a marker is missing.