FAQ

A few common questions — tap any to expand.

Is this site really just Markdown files?

Yes. Every page you see is a plain .md file under content/, read at build time — no database, no CMS. Editing a file, committing, and pushing to main rebuilds and redeploys the live site. The Style Guide shows everything the Markdown supports.

How do I add a new page or project?

Drop a new file in content/projects/. The filename becomes the slug (field-notes.md/projects/field-notes), and the frontmatter title and order decide how it shows in the index. Tags are optional and feed tags.

Why is there no dark-mode toggle?

By design. The theme follows your operating system via prefers-color-scheme — the whole UI is driven by CSS tokens, so it flips automatically. One less switch to think about.

Can I reuse this as a template?

That's the plan. The engine is stable and only the content/ folder changes per site, so it can become a GitHub template or a create- scaffolder. The Roadmap tracks where that's going.

How does search work?

The ⌘K palette is backed by a small index built at compile time from the same Markdown — titles, headings, and body text for every page, project, and post. It's fetched lazily, so it never weighs down the initial load.