Skip to content

Tell the site when a release is published - #9

Merged
migsilva89 merged 1 commit into
mainfrom
tell-the-site
Aug 31, 2026
Merged

migsilva89 merged 1 commit into
mainfrom
tell-the-site

Conversation

@migsilva89

@migsilva89 migsilva89 commented Aug 31, 2026

Copy link
Copy Markdown
Owner

The site reads its version and download size from a file in its own repository, so it asks GitHub nothing while it builds. A schedule on that side kept the file current by polling this repository every half hour.

GitHub does not honour that schedule. On a repository with little traffic it drops the ticks rather than queueing them. Measured on each site's own workflow runs, the real gaps:

imark-site 6.1h, 2.2h, 2.6h, 3.0h, 4.5h
loadout-website 6.7h, 4.2h, 2.3h, 3.0h, 3.7h
unbury-website 2.1h, 6.4h, 2.7h, 2.4h, 3.0h, 3.7h, 4.7h

So every release spent between two and six hours with the website still offering the previous version. That is what happened to Unbury 0.1.1 today, and it has been happening quietly to all three for weeks.

What this does

Publishing a release pokes the matching website repository directly, and it rebuilds in seconds. The schedule stays on the other side as a safety net for the case where this step fails.

It needs one secret, and works without it

SITE_DISPATCH_TOKEN — a fine-grained token with Contents: write on the site repository, which is what repository_dispatch requires.

Until that secret exists the step warns and passes rather than failing. A red cross on a release that published perfectly reads as a broken release rather than as a missing setting, and the site still catches up on its own schedule in the meantime — hours late, but correct.

permissions: {} — nothing here reads or writes this repository. The only credential is the one that reaches the other one.

The site reads the version and the download size from a file in its own
repository, and a schedule there kept that file current by asking this
repository every half hour. GitHub does not honour that schedule: on a
repository this quiet it drops the ticks rather than queueing them, and
the measured gaps run from two to six hours. Every release spent an
afternoon with the website offering the previous version.

Publishing a release now pokes the website's repository directly, which
rebuilds in seconds. The schedule stays on the other side as a safety net.

Without SITE_DISPATCH_TOKEN this warns and passes rather than failing: a
red cross on a release that published perfectly reads as a broken release
rather than as a missing setting.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@migsilva89
migsilva89 merged commit f480236 into main Aug 31, 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