Skip to content
@jordanlee
documentation

Getting Started

Introduction

What this theme is, what it includes, and how it is organized.

on this page

What is this theme?

Astro Mono is a monochrome, typography-first theme for personal and portfolio sites. It grew out of a Hugo site built on the Coder theme and keeps that spirit — a centred avatar on the homepage, a plain list of posts, bordered project cards — while adopting the conveniences of a modern Astro setup.

Everything is driven by one configuration file, content is typed, and the whole site ships with almost no JavaScript. The one indulgence is the animated starfield behind the page — a couple of kilobytes of script that a single flag turns off.

What’s included

  • Posts — Markdown/MDX, tags, series navigation, table of contents, prev/next, reading time, RSS.
  • Projects — a card grid with a client-side skill filter; a project gets its own page only when it has body content.
  • Docs — this section: grouped sidebar, table of contents with scroll-spy, prev/next.
  • Pages — any Markdown file in src/content/pages/ becomes a top-level route (about.md → /about).
  • Starfield — a faint, slowly turning field of stars behind the page, drawn on a plain canvas.
  • Light & dark — one toggle, no flash on load, a configurable default.
  • SEO — canonical URLs, Open Graph, Twitter cards, JSON-LD, sitemap, robots.txt.
  • Snippets — Expressive Code for the occasional code block: titles, line numbers, highlights.
  • Authoring components — <Callout> and <Tabs> for MDX.

How it is organized

src/
├── config/site.ts every setting
├── content/ posts/, projects/, docs/, pages/
├── content.config.ts collection schemas
├── components/ ui/, layout/, posts/, projects/, docs/
├── layouts/ Base, Post, Project, Docs, Page
├── pages/ file-based routes (+ rss.xml.ts, robots.txt.ts)
├── styles/ global.css (tokens), typography.css (prose)
└── lib/ content.ts, seo.ts, utils.ts, markdown-plugins.ts

Next: Installation.