saicaca/fuwari

Fuwari is a ready-to-use blog template built on top of Astro, a tool that generates static websites from source files. You use it as a starting point to create your own personal blog, then deploy the finished site to services like Vercel, Netlify, or GitHub Pages. The name comes from a Japanese word for something soft and light. Setting up a blog from this template takes a few steps: you create a copy of the repository (either by forking it or using a create command from the terminal), install the dependencies, edit a configuration file to set your site title and other preferences, and write posts as Markdown files in a specific folder. Each post uses a short header section at the top called frontmatter, where you specify the title, publication date, tags, category, and whether the post is still a draft. The template includes several features beyond basic Markdown rendering. There is a light and dark mode toggle, smooth page transition animations, a search bar powered by Pagefind (a library that indexes your content locally without a server), an RSS feed so readers can subscribe, and a table of contents generated automatically from your post headings. You can also customize the color scheme and banner image through the config file. The README is also available in Chinese, Japanese, Korean, Spanish, Thai, Vietnamese, and Indonesian. Markdown support is extended beyond the standard to include admonition blocks (styled notes, warnings, and tips), embeddable GitHub repository cards, and enhanced code blocks with richer syntax highlighting via Expressive Code. The template requires Node.js version 20 or newer and uses pnpm as the package manager. It is released under an MIT license.