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.
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.