Revamped Astro Zozo is a sample-first Astro 6 starter theme for editorial blogs, creative portfolios, and personal publishing sites. It builds on the lightweight writing flow of astro-blog-zozo and adds a warmer visual system, richer content surfaces, and pages that go beyond a simple post list.
Key features
- Split-hero Home and About layouts for editorial landing pages
- Blog with tags, timeline archives, reading time, and RSS
- Gallery with category walls, viewer pages, notes, and optional character-focus hotspots
- Friends page for curated link cards
- Pagefind full-text search
- Light and dark mode with a persistent theme toggle
- KaTeX math support, Shiki code highlighting, and dynamic Open Graph images
- Giscus comments support (hidden by default until configured)
Who it is for
This theme works well if you publish long-form writing, maintain a visual gallery, or want a personal site that feels more like a magazine than a barebones blog starter.
What changed from Astro Zozo
Compared with the original Astro Zozo baseline, this branch keeps the fast writing workflow intact while adding:
- a warmer light and dark theme with a more deliberate surface system
- a Friends page for curated links
- a Gallery route with category walls, notes, and optional character-focus interactions
- a more compact mobile menu
- a content structure that is easier to replace with your own markdown and media
It also keeps explicit attribution to the upstream lineage instead of pretending the project appeared from nowhere.
Getting started
- Clone the repository
- Run
bun installornpm install - Run
bun run devornpm run dev - Replace branding in
src/config.ts, posts insrc/content/posts/, gallery entries insrc/content/gallery/, and friends data insrc/data/friends.ts
If you are turning this into your own site, the main things to replace are branding, posts, gallery entries, and social links. Sample photos in this branch are from Unsplash.
Credits
This project is a derivative of astro-blog-zozo by Ladit, inspired by hugo-theme-zozo.