Back to themes

Astro Keel

A minimal, editorial portfolio and blog theme for Astro 7. Typed content collections, light/dark mode, MDX, RSS, sitemap, and SEO-ready Open Graph metadata — with zero client-side JavaScript.


Cost

Free


Created by
kpab

Astro Keel is a structural-minimalist theme for portfolios, essays, and professional notes. It pairs editorial serif typography with a disciplined baseline rhythm and a single accent carried through fine "keel" rule lines — readable first, decorative last.


Built for Astro 7

Astro Keel is built on the Astro 7 Content Layer API. Works and blog posts are loaded through the glob loader with fully typed Zod schemas, so your projects and writing stay predictable and type-safe. Output is static and zero-JS by default — only a tiny theme-toggle script ships to the browser.


Features

  • Two typed content collections — Works (case studies) and Blog (notes/essays)
  • MDX support with Shiki dual-theme code highlighting (light + dark)
  • Light/dark mode with system preference and persisted user choice
  • Tag pages, publish dates, draft filtering, and per-entry hero/thumbnail images
  • Editorial type system: Fraunces, Public Sans, and JetBrains Mono
  • Retune the whole palette from a single CSS custom property


SEO & performance

  • Per-page canonical URLs, Open Graph and Twitter Card metadata out of the box
  • Auto-generated sitemap and RSS feed
  • Semantic, accessible markup with reduced-motion support
  • Fast static HTML — great Core Web Vitals with no hydration cost
  • Base-path aware, with a ready-to-use GitHub Pages deploy workflow


Customize in one line

The accent color is a single CSS variable (--color-accent). Change one line to retune the entire theme — links, buttons, rules, and focus states all follow.


Who it's for

Developers, designers, and writers who want a calm, fast, content-first site that takes durable technical work seriously.