Daybook is a quiet, paper-like blog theme for Astro, built around one idea: write a short entry a day, and let the page feel like a journal instead of a feed of cards.
The home page lists entries by day, grouped by month, with a narrow date rail on the left. Pinned entries get their own group at the top, and long entries collapse to an opening excerpt until the reader asks for the rest. Alongside the diary there is a separate space for longer posts with categories, tags and keywords.
Features
Diary-first home page: one entry per day, grouped by month, with a date rail and a pinned group
Paper-like layout: warm paper background, 1px rules, generous whitespace, soft pink accents, no cards and no shadows
Dark mode that follows the system or a manual toggle, applied before first paint so there is no white flash
Full-text search built at postbuild time with Pagefind, in a custom panel with All / Diary / Posts / Pages tabs
Long entries collapse on the home page and expand in place
Content extras: table of contents, Shiki code highlighting in light and dark, KaTeX math, footnotes, and a lightbox for images
Optional password-locked entries, encrypted with PBKDF2-SHA256 and AES-GCM and decrypted in the browser
Comments via Twikoo, Waline or Artalk, each loaded lazily and only when configured
Archive by year and month, plus a writing heatmap of the days you wrote
Three RSS feeds (all, diary, posts), sitemap, robots.txt and generated Open Graph images
A music page with a small in-site player
Four UI languages (Simplified Chinese, Traditional Chinese, English, Japanese), one per build
Mobile-first navigation: a drawer on small screens plus a bottom navigation bar
Strict validation: site config and frontmatter are checked with Zod 4, and a wrong field stops the build and names the field
Sample content included: entries and posts that exercise pinning, drafts, hidden entries, an encrypted entry, nested folders and MDX
AGENTS.md plus docs for configuration, content and the music player, so both humans and AI agents can customise it
Links
Repository: https://github.com/God-2077/astro-daybook
Live demo: https://daybook.demo.ksable.top/
Configuration docs: https://github.com/God-2077/astro-daybook/blob/main/docs/configuration.md
Content docs: https://github.com/God-2077/astro-daybook/blob/main/docs/content.md
The docs are written in Chinese; the README is also available in English, Japanese and Traditional Chinese. The demo above is the Simplified Chinese build.
License
AGPL-3.0. The bundled ChillRound font subset is under OFL-1.1, and lightGallery is GPLv3 or commercially licensed.







