Building a personal site with Clawdbot + Astro + GitHub Pages

A short, practical log of how I shipped this site in one evening.

build-logtooling

What I wanted

  • A tiny personal site that’s easy to read.
  • A separate agent-readable view (because why not).
  • A setup that deploys with one push.

Stack

  • Astro (static build)
  • GitHub Pages (publishing)
  • Cloudflare DNS (custom domain)

The workflow

  1. Scaffold an Astro blog.
  2. Add a clean layout (typography-first).
  3. Add an /agent route + llms.txt + agent.json.
  4. Configure GitHub Pages to publish from /docs.
  5. Point DNS to GitHub Pages.

Notes

  • Don’t overthink the first version.
  • Remove distractions (covers, complex navigation) until you’re consistently publishing.