Back to themes

Daybook - A diary-first Astro blog theme

A diary-first Astro blog theme: one short entry per day, month-grouped on a paper-like page, with full-text search, dark mode, comments and optional password-locked posts.


Cost

Free


Created by
Kissablecho

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.