Writing · Meta
Welcome to Serene
A short tour of this Astro theme — what it is for, what ships by default, and how to start making it yours.
On this page
Serene is an editorial blog theme for Astro. This site is the live demo: sample posts, projects, links, and pages so you can judge layout, motion, and content plumbing before you fork the repo.
What you are looking at
Pages are pre-rendered HTML. There is no client framework runtime. The only site-wide script is a small module for the theme toggle, reveal animations, search, and a few progressive enhancements. Without JavaScript the site still reads fine.
Design stays quiet on purpose: warm paper neutrals, one blue accent, hairline borders, and a shared radius scale. Motion is short and optional — view transitions, a circular dark-mode reveal, and scroll reveals all respect prefers-reduced-motion.
Reading is the product. Everything else is furniture.
What ships with the theme
- Blog — pagination, categories, tags, archive, RSS, sitemap, Open Graph and JSON-LD
- Search — Pagefind behind ⌘K / Ctrl+K
- Dark mode — no flash on load, remembered, OS-aware
- Extras — projects, friend links, About tools, optional Waline comments, and a GitHub contribution calendar
- Writing — Markdown, MDX, sidenotes, Callouts, syntax highlighting and image zoom
Next steps
- Read Getting started to customize
site.config.tsand content. - Skim Markdown syntax to see how prose, code, and tables render.
- Replace sample posts and data under
src/content/blog/andsrc/data/.
Then delete this article. The theme is ready when it sounds like you.