Skip to content

Fuwari

Fuwari is a free, animated Astro blog theme with a polished design. It includes search, categories, page transitions, and supports both file-based and folder-based content.

  • Page transitions (Swup.js)
  • Search (Pagefind)
  • Tags and categories
  • Drafts
  • Cover images
  • Reading time
  • LaTeX/KaTeX math rendering
  • Callouts/admonitions (GitHub-style)
  • GitHub card embeds
  • Expressive Code (enhanced code blocks)
  • Archive page
  • RSS feed
  • Prev/next post navigation
  • Table of contents

Fuwari supports both file-based and folder-based content:

  • File-based: src/content/posts/my-post.md
  • Folder-based: src/content/posts/my-post/index.md (with images alongside)
PropertyTypeDescription
titlestringPost title (required)
publisheddatePublication date (required)
updateddateLast updated date
draftbooleanHide from production
descriptionstringShort description
imagestringCover image path
tagsstring[]Tags
categorystringCategory
langstringLanguage code

Fuwari works well with the GitHub template workflow:

  1. Go to Fuwari’s GitHub repo and click “Use this template”
  2. Clone your new repo locally (using SourceTree, GitHub Desktop, or the terminal)
  3. Install Vault CMS:
    Terminal window
    npx create-vaultcms
  4. Open the project as a vault in Obsidian
  5. Complete the setup wizard
  • No wikilinks, highlights (==text==), or image grids
  • No Mermaid diagram support
  • No linked mentions, related posts, or local graph
  • No dedicated Obsidian settings plugin
  • Single content type (posts only, plus a spec collection)

Free and open source (MIT).