Skip to content

Back

Colophon

How this site is built. The portfolio is a work sample too, so this page shows its working.

Built with

  • Framework

    Astro, static output

    Every page is plain HTML built ahead of time. There is no server to maintain and no client-side framework to download.

  • Interaction

    Native elements and a few kilobytes of script

    The command palette is a dialog, the appearance panel is a popover, and page transitions are the browser’s own. No interface library.

  • Content

    One JSON file of facts, and a file for each case study

    The home page, CV, PDF, structured data and social images are all generated from content/resume.json, so they can’t disagree.

  • Styling

    Tailwind CSS 4 on custom tokens

    Tailwind’s defaults are switched off. A size, gap or colour that isn’t in the token file doesn’t exist as a class.

  • CV

    Playwright prints the CV page to PDF

    The PDF is the web page’s print stylesheet, checked on every build to be exactly one page of extractable text.

  • Images

    AVIF and WebP at build time

    Screenshots are captured from the public demos by a script and resized for each screen.

  • Social images

    Satori, at build time

    One per page, drawn from the same data.

  • Hosting

    Vercel, as static files

    Every push builds the site from git. The output is a plain folder, so nothing ties it to one host.

The source is public

Type

One family: Inter, by Rasmus Andersson, under the SIL Open Font License. It is self-hosted as a single variable file, cut down to Latin characters and the weights 400 to 600, with the optical-size axis kept so large headings use the display cut.

Round quotes and commas are switched on everywhere. Running text also uses a tailed lowercase l, so I, l and 1 can’t be confused. Numbers in tables and dates are tabular. Sizes follow a 1.25 scale that grows with the screen.

Colour

A 12-step cool neutral and one accent, defined in OKLCH and tuned separately for light and dark. The accent means one thing: this goes somewhere, or this has focus.

Two things sit outside that scale: a teal, green and blue wash behind each page’s title, and the dark band for BodyMed Hub, on the home page and at the top of its case study, which stays dark in both themes.

  • Neutral 1
  • Neutral 2
  • Neutral 3
  • Neutral 4
  • Neutral 5
  • Neutral 6
  • Neutral 7
  • Neutral 8
  • Neutral 9
  • Neutral 10
  • Neutral 11
  • Neutral 12
  • CanvasThe page
  • SurfaceCards
  • WellInsets and code
  • InkText
  • MutedSecondary text
  • AccentLinks, focus, the primary action

Glass

Glass is a material for floating controls only: the navigation, the command palette, the appearance panel and toasts. It never sits behind body text, and the site is complete without it.

Solid
The default: an opaque surface, a hairline and a shadow. Used with Reduce glass on, when your system asks for less transparency or more contrast, and in browsers without backdrop blur.
Frosted
A tinted layer over a blurred backdrop, with a soft dark rim, a bright top edge and a soft shadow. The blur grows with how far the surface floats above the page.
Refracted
In Chromium browsers the navigation also bends what is behind it along its rim, like the edge of a lens.

The tint is heavy enough that text on glass keeps at least 4.5:1 whatever scrolls underneath. Reduce glass is in the appearance panel in the navigation, and is applied before the page first paints.

Motion

Motion is short and only used for feedback and continuity. No interface motion runs longer than 300 ms, and nothing fades in on scroll.

A few things move by themselves. Three do it once: the booking story on the home page (under five seconds, with a replay button), a picture travelling from the home page to its case study, and the new theme opening from the control that asked for it. One loops: the silent walkthrough at the top of the BodyMed Hub case study, on screens wide enough for it, with a pause button beside it. The line through a case study’s pipeline is drawn by your own scrolling. With reduced motion switched on in your system settings none of these run, the two shortest durations drop to zero and the rest become quick cross-fades.

Micro
120 ms
Hover and press
Fast
180 ms
Toasts, small reveals
Base
240 ms
Moves on screen
Slow
300 ms
The ceiling for any interface motion

Numbers

  • 99

    Lighthouse performance

  • 100

    Lighthouse accessibility

  • 100

    Lighthouse best practices

  • 100

    Lighthouse SEO

  • 1.65 s

    Largest Contentful Paint, slowest page

  • 0

    Cumulative Layout Shift

  • 4 KB

    JavaScript on the home page

  • 47 KB

    Fonts, one file

Measured on . Lighthouse mobile emulation and axe-core, run against a local production build served with gzip, as the host serves it. Lighthouse figures are the worst result across all pages, except the 404 page’s SEO score, which is lower by design because that page asks not to be indexed. JavaScript is the home page’s total, gzipped.

Accessibility

The site aims for WCAG 2.2 AA. An automated axe-core check runs on 9 pages, each in16 combinations of theme, screen width, reduced motion and Reduce glass, and currently reportsno violations.

Every page has one main heading, a skip link and visible focus rings. Touch targets are at least 44 pixels. Text is at least 4.5:1 against its background in both themes. The pages work with JavaScript switched off.

Automated checks don’t catch everything. If something doesn’t work for you, please email me.

Credits

Pages

Home
Selected work
BodyMed HubCase study
AI email triageCase study
Jarvis site monitorCase study
About
CV
Colophon

Actions

Copy email addresscian.mccaul@outlook.com
Download CVPDF
Light theme
Dark theme
System theme
Reduce glass

Elsewhere

GitHub
LinkedIn
Email mecian.mccaul@outlook.com