The Astro site at obediencecorp.com, deployed to GitHub Pages from main.
just install
just devOpen http://127.0.0.1:4321. The development server runs in the background; use just status, just logs, and just stop to manage it. Local contact forms simulate submission and do not send messages.
just test # Production build and output checks
just releases test # Importer integration tests in DockerThe integration tests create and replace fixture snapshots, so they run in a disposable container. Docker must be running. CI runs the same tests inside a Node container.
/releases/ lists the complete published release history of every public repository in the Obedience-Corp organization. It includes repository archives, search, a stable-only filter, and /releases/feed.xml. Recent stable releases from three different repositories also appear on the homepage.
The importer discovers repositories on every run and follows every repository and release API page. New public projects appear automatically once they have a release. Drafts and private repositories are excluded; prereleases are labeled. Public forks and archived repositories retain their published history. Edits, deletions, and repositories made private are reflected on the next successful sync.
Festival, Fest, Camp, and Festival Installer entries link to their release pages on fest.build. Other projects have individual release pages here, with canonical URLs and sitemap modification dates. GitHub remains the source for release notes and downloads. Imported Markdown supports tables, code, and links; embedded HTML is escaped and unsafe URL protocols are disabled.
.github/workflows/releases.yml runs hourly, on importer changes merged to main, and through Actions → Sync public releases → Run workflow. It uses the built-in GITHUB_TOKEN; no additional secret or repository list is needed.
- Discover all public repositories and fetch their published releases.
- Replace
src/data/releases.jsononly after every request succeeds. Network failures preserve the previous snapshot. - If content changed, build and test it, then commit only the validated snapshot to
main. - Call the existing Pages deployment workflow with that exact commit. This explicit call is necessary because pushes made by
GITHUB_TOKENdo not trigger another push workflow.
Unchanged content produces no commit or deployment. Concurrent pushes are never overwritten: a rejected push fails the run, and the next scheduled run starts from the latest main. If deployment fails after publishing a snapshot, rerun the failed workflow from Actions. GitHub controls scheduled execution timing, so updates may arrive later than the scheduled minute.
The checked-in snapshot supplies the initial historic archive immediately after deployment. Builds and visitors do not depend on live GitHub API requests. The hourly workflow starts when merged to main.
For a manual authenticated import:
GITHUB_TOKEN="$(gh auth token)" just releases sync
just test
just releases testCommit the resulting snapshot with the project's normal workflow. Tokens are read from the environment and never stored in the snapshot.