Site Architecture Notes

A brief overview of how this site is built and the decisions behind it.

Stack

• Generator: Eleventy (11ty) v3 — fast, zero-config static site generation
• Hosting: GitHub Pages with GitHub Actions CI/CD
• Styling: Custom CSS with a dark, high-contrast operator-console palette and a mixed sans/mono type system
• Interactivity: Vanilla JavaScript — command bar, keyboard paging, and client-side search

Design Philosophy

The visual system is tuned for a cybersecurity software practice: dark surfaces, strong contrast, compressed hierarchy, and utility labels that feel closer to an operator console than a marketing page. The goal is to make scanning easy without sacrificing long-form readability.

Content Workflow

1. Write a Markdown file in src/reports/
2. Add frontmatter (title, date, category, tags)
3. Commit and push — GitHub Actions builds and deploys

No CMS. No build tools beyond npm and Eleventy. The site should stay maintainable with a text editor and a small toolchain.

Search

Client-side search is built from a JSON index generated at build time. No external services, no API calls. The search index contains titles, tags, and content excerpts for all reports.