Skip to content

0010 pages hosting

github-actions[bot] edited this page Nov 17, 2026 · 2 revisions

The website is hosted on GitHub Pages at librelifts.app

Status: accepted · Implementation: done · Date: 2026-11-17

Settles the hosting question ADR 0009 left open. Built: the workflow, the build check, the Pages source and custom domain. First deploy 2026-11-17: GitHub serves the site for librelifts.app. Still open at that date: DNS for the domain did not yet point at GitHub, so the address was not reachable and Enforce HTTPS was off.

Context

ADR 0009 made the website a static Astro site and left hosting open. The site is a folder of files with no server-side logic. The repository is public and on GitHub, where Pages hosts static sites for free, and Spotcraft's website is already published the same way.

Decision

  • GitHub Pages hosts the website, with the repository's Pages source set to GitHub Actions.
  • .github/workflows/pages.yml deploys it on every push to main that touches the website, and can be run by hand.
  • The address is librelifts.app, set as the Pages custom domain and in apps/website/public/CNAME. site in the Astro config uses it.
  • The build checks itself: it fails if a built page has a <script>, or a link, anchor or asset on it doesn't resolve.

Consequences

  • A change to the website on main is live within minutes, with no server to run.
  • Pages can't send response headers. That is fine for this site; the web app (ADR 0007) is not hosted here, and where it runs is a separate decision.
  • .app domains only work over HTTPS, so the site is unreachable until DNS points at GitHub and the certificate has been issued.
  • The website depends on GitHub being up, and on the domain being renewed.

Clone this wiki locally