Introduction

Tranquility is a Hexo theme designed for personal homepages and multi-discipline bloggers. Guided by the design philosophy of "tranquility and distance" (宁静致远), it focuses on personal branding and clear domain boundaries across blog content.

Design Philosophy at a Glance

Unlike most Hexo themes, Tranquility's homepage shows no article list — instead it displays identity-focused modules like About, Timeline, Projects, and Skills. The concept of "Subpage" replaces "Category": each subpage maps to a broad discipline and gets a top-level navbar entry; within a subpage, posts are aggregated by tags.

This design serves two needs: a homepage that showcases personal identity, and clear domain boundaries for multi-discipline content. See Design Philosophy for details.

Key Features

Personal homepage

• Identity-focused homepage: About, Timeline, Projects, Skills
• Supports a pure homepage mode (no articles, aggregates external blog RSS)
• "Subpage" design for multi-discipline writing
• Recent Updates cards aggregating external blog RSS at build time — stable loading in mainland China
• Announcement banner, site uptime counter, Hitokoto slogan, reward

Writing

• Post cover, TOC, sticky posts, excerpt
• Related posts, tag cloud, code highlighting
• Math formulas (MathJax), Mermaid diagrams

SEO & discoverability

• Open Graph / Twitter Card social cards, JSON-LD structured data
• Sitemap, robots.txt, RSS auto-discovery
• Search: local search with no external service, optional Algolia DocSearch

Performance / experience / security

• Dark mode with four strategies (light/dark/scheduled/follow-browser)
• PWA offline access, content-fingerprinted asset caching, font subsetting
• Back-to-top button, prefers-reduced-motion accessibility degradation, lazy image loading, responsive across desktop/tablet/mobile
• CSP security policy, build-time URL validation, XSS injection protection

Demo Sites

• Tranquility Demo (full feature showcase, rebuilt automatically on every commit)
• Tranquility (original theme demo)
• Hozen's Homepage

Fork Notice

This repository is a fork of hooozen/hexo-theme-tranquility. The original repository was archived in June 2026 and is no longer maintained. This fork continues maintenance, adding features and fixing bugs on top of the original, including: Hitokoto slogan, article-driven timeline, Hexo native about page, build-time RSS-aggregated "Recent Updates", runtime dark mode, Open Graph / JSON-LD / sitemap / robots.txt / RSS auto-discovery, PWA, lazy image loading, back-to-top button, accessibility degradation, font loading optimization, security hardening (XSS / CSP / injection protection), projects showcase, skills display, announcement banner, site uptime counter, and more.

See the Changelog and Releases for the full version history.

Next Steps

• Install the theme — up and running with npm in a minute
• Configuration — personalize your site
• Design Philosophy — understand the "Subpage" and "Tag" split