irfan in irfanadziri.dev in ~/colophon on main via astro v7.4.12
Colophon
How this site is built and run: the pinned stack, fonts and licences, the deploy pipeline and its one stored credential, analytics, accessibility and the content licence.
This site is static HTML, built at deploy time and served from GitHub Pages behind Cloudflare. There is no server, no database and no client-side router. Most pages ship no JavaScript beyond the theme toggle and the search palette, which loads only when you open it.
The source repository is private, as every version of this site before it was. This page describes the pipeline instead of linking to it.
Stack
Every version below is pinned exactly in the build, and this table is generated from those pins, so it can’t drift.
| Layer | Tool | Version |
|---|---|---|
| Framework | Astro | 7.4.12 |
| Content | MDX (@astrojs/mdx) | 8.1.6 |
| Islands | Preact | 11.2.0 |
| Styling | Tailwind CSS | 4.3.5 |
| Code highlighting | Shiki | 4.6.0 |
| Search | Pagefind | 1.6.0 |
| Diagrams | D2 | 0.9.0 |
| Social cards | satori + resvg | 0.63.2 / 2.6.2 |
| Language | TypeScript | 6.0.3 |
Node is the GitHub runner’s own, not pinned: the deploy workflow is carried over unchanged from the previous site, and it has no Node setup step.
Diagrams are written in D2 and rendered in its sketch mode at build time. The SVGs are committed to the repository, so the deploy needs no diagram tooling, and a CI check fails any pull request whose committed SVGs don’t match their sources.
Fonts and licences
Three families, all self-hosted, Latin subsets only, no requests to a font service:
- Archivo (variable) for display type. SIL Open Font License 1.1.
- IBM Plex Sans for body text and IBM Plex Mono for labels and code. SIL Open Font License 1.1.
- Fuzzy Bubbles for diagram labels, cut down to the characters the diagrams use. SIL Open Font License 1.1.
The two faces the first screen needs are preloaded. The rest load only on pages that use them.
Build and deploy
A merged pull request into main triggers a GitHub Actions workflow: install, build, index the site for search with Pagefind, then publish dist/ to the GitHub Pages repository that serves the domain.
That publish step authenticates with a long-lived personal access token stored as a repository secret. One of the system write-ups on this site, Pipelines that hold no credentials, argues against exactly that kind of stored credential. The workflow was kept identical to the previous site’s for the cutover, so the token came with it. Replacing it with a deploy key, or a token scoped to the one target repository, is on the list after launch.
Before anything reaches main, every pull request runs type checks, a content lint (template sections, tags, employer names, links between pages), the diagram check, resource budgets per page, an automated accessibility scan in light and dark themes, Lighthouse and a link check.
Analytics
Page views and a handful of button clicks are counted with Umami Cloud. It sets no cookies and stores no personal data, so there is no consent banner. It honours Do Not Track. Search queries are never sent; only the fact that search was opened.
Accessibility
The target is WCAG 2.2 AA. Every page is checked with axe in both themes on each pull request; colour pairs were contrast-checked when the palette was set. Everything works with a keyboard, focus is always visible, and motion respects prefers-reduced-motion. If something doesn’t work for you, email works@irfanadziri.dev and I’ll fix it.
Licence
The text of the writing, case studies and system write-ups is licensed CC BY-NC 4.0: share and adapt it for non-commercial use, with credit. Everything else on the site, including resume.pdf, photographs, the cat and the design, is all rights reserved.