Skip to content

Generate the repository directory from the GitHub API - #6

Merged
KhronosWebservices merged 2 commits into
mainfrom
automated-site
Nov 17, 2026
Merged

KhronosWebservices merged 2 commits into
mainfrom
automated-site

Conversation

@KhronosWebservices

Copy link
Copy Markdown
Member

Replaces the hand-edited index.html and the prebuilt Bootstrap 3 bundle with a site generated from the GitHub API.

What changes

  • The page lists the public KhronosGroup repositories grouped by standard, with three ranked lists (most starred, trending, most active) and a filter box.
  • Private, archived, Registry and forked repositories are not listed. The headline figure counts all public repositories.
  • npm run build fetches the data and builds dist/ with Vite and Tailwind CSS. Light and dark themes follow the system setting.
  • .github/workflows/build.yml builds on push to main, daily, and on manual dispatch, then deploys to GitHub Pages. Pull requests build from data/sample.json and upload a site-preview artifact.
  • The repository is REUSE 3.3 compliant: Apache-2.0 OR MIT, logos CC-BY-ND-4.0.

README.md documents the commands, the listing rules, the configuration files and the deployment.

Deployment notes

  • Pages > Source must be "GitHub Actions" before this merges. The branch build would publish the unrendered template.
  • Traffic data needs the organization GitHub App (APP_CLIENT_ID, APP_PRIVATE_KEY). Without it the workflow uses its own token and the Trending list stays empty until star snapshots accumulate.

Replace the hand-edited index.html and the prebuilt Bootstrap 3 bundle
with a generated site.

Build
- scripts/fetch.mjs queries every public KhronosGroup repository
  (GraphQL) plus 14 day traffic (REST) into data/repos.json.
- scripts/lib/score.mjs applies exclusions, health tiers, grouping and
  rankings. Covered by node --test.
- Vite renders index.html and src/templates/page.njk with Nunjucks and
  compiles Tailwind CSS v4. Light and dark follow prefers-color-scheme.
- npm run build runs fetch and bundle. Without GH_TOKEN the build uses
  the committed data/sample.json.
- .github/workflows/build.yml builds on push, daily and on dispatch,
  stores daily snapshots on the data branch, and deploys to Pages.
  Pull requests build from the sample and upload a preview artifact.

Decisions
- Private, archived, Registry (name match), fork and .github
  repositories are not listed. The headline figure counts all public
  repositories.
- Stale repositories are listed (hide_stale: false). Health tiers only
  set the card marker.
- Raw traffic numbers are not published and are left out of the sample
  fixture. Traffic only orders the Trending list.
- The khronos.org mega navigation is replaced by a short navigation.
- Unused logos, legacy font formats, jQuery, fancybox and Font Awesome
  are removed.

Licensing
- REUSE 3.3 compliant. Apache-2.0 OR MIT, copyright The Khronos Group,
  Inc. Logos are CC-BY-ND-4.0. Open Sans is Apache-2.0, Google
  Corporation. CONTRIBUTING.md keeps CC-BY-4.0.
- Headers are in the files. REUSE.toml covers JSON, PNG, WOFF2 and
  CNAME only.

Pages must be switched to the "GitHub Actions" source when this merges.
The legacy branch build would publish the unrendered template.
@KhronosWebservices
KhronosWebservices merged commit 2a415a7 into main Nov 17, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant