Skip to content

Website stack: Astro static site on Cloudflare Pages, own components, no theme

Decided 2026-09-10. embeddedera.com is rebuilt as an Astro 5 static site in embeddedera-site, deployed by Cloudflare Pages (free: unlimited requests/bandwidth, 500 builds/mo). WordPress.com is retired after a week of the static site being live.

Why

  • Free beats paid: Pages + Astro + GitHub = $0; WordPress.com plan stops.
  • Already in the codebase: the Astro portfolio (angelEmbeddedEra.github.io) has the layout, nav, cards, site.ts config pattern, comment-stripping remark plugin and 14 real board photos. A five-page site plus case studies does not justify a 300-file theme.
  • Scout pass (Haiku, 2026-09-10): AstroWind (MIT, most used), Astroship (GPL), Astroplate (MIT), ScrewFast (MIT, landing + Starlight docs in one repo). Section patterns borrowed from AstroWind/ScrewFast; no code vendored.
  • 3D boards: <model-viewer> + GLB from kicad-cli pcb export glb (KiCad 8/9). Draco-compress to < 5 MB.
  • Docs: Starlight inside the same repo at /docs (ScrewFast pattern), later.

Product tools stay in their repos

EmbeddedEra/The_Real_Cow_Flasher (WebUSB DFU) and EmbeddedEra/The_Real_Cow_Configurator (Web Serial) each get their own Pages project on flasher. / configurator.embeddedera.com, gated with Cloudflare Access (email OTP, ≤ 50 users free) when distributors need them. Both need HTTPS and Chrome/Edge. Do not copy them into the site repo. Once gated, disable their public GitHub Pages or the gate is decorative.

Dark theme tokens

bg #0b0d10 · surface #14181d · border #232a32 · text #e6e9ee · muted #9aa3ad · copper #c8813f (hover #e09a57) · gold #e8c46a.

See embeddedera-site for the phases and open items.