An Astro blog theme modified from Fuwari, retaining the original page structure and reading experience
fuwari-modified — Astro Blog Template
By ANcRyel
An Astro blog theme modified from Fuwari, upgraded to Astro v5 and Tailwind v4, replacing Svelte with Alpine.js, and adding background-image card overlay, homepage text, and a scroll progress bar.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Upgraded to Astro v5 and Tailwind v4, with Alpine.js replacing the original Svelte
Added a visual treatment combining a background image with card overlay
Added homepage text display and a reading scroll progress bar
Site configuration, posts, and the about page are centralized in src/config.ts, src/content/posts/, and src/content/spec/about.md respectively
Template Details
fuwari-modified is an Astro blog theme modified by ANcRyel from saicaca's Fuwari template, released under the MIT license. It retains the original Fuwari page structure and reading experience, with the main changes concentrated in the tech stack and a few interface features.
On the technical side, the theme upgrades to Astro v5 and Tailwind v4, and replaces the original Svelte with Alpine.js; no specific dependency lock information for TypeScript-related versions is provided in the available materials. On the feature side, three items are added: a background image with a card overlay effect, homepage text display, and a scroll progress bar while reading. The README still contains unchecked items such as "upgrade to Astro v7" and "upgrade to TypeScript v6," indicating these directions are not yet complete.
For usage, site configuration is located in src/config.ts, posts are placed in src/content/posts/, and the about page corresponds to src/content/spec/about.md. More complete instructions on deployment, theme customization, and project structure require referring to the original Fuwari README. The README also notes that much of the text in the project is AI-translated and may contain inaccuracies.
Is it right for your project?
Use Cases
- Building a personal blog focused on article reading while wanting to keep Fuwari's page structure
- Needing interface changes such as a background image, card overlay, and scroll progress bar on top of Fuwari
- Wanting an Astro blog project that uses Alpine.js instead of Svelte
- Referring to how this repository modifies Fuwari to adjust configuration or continue secondary development
Suitable For
- Developers familiar with Astro who are willing to organize content according to src/config.ts and src/content/posts/
- Users who accept the original Fuwari README as the primary reference for deployment and customization
- Individuals or teams needing a blog theme that can be modified and distributed under the MIT license
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
The README states Node.js >= 22 and pnpm >= 11; specific dependency versions are subject to the repository lockfile
- 2
Site configuration is in src/config.ts, posts are in src/content/posts/, and the about page is in src/content/spec/about.md
- 3
More instructions on deployment, theme customization, and project structure require referring to the original Fuwari README
- 4
The README notes that much of the project content is AI-translated and may contain inaccuracies
- 5
Third-party assets such as demo images, fonts, and icons must be checked separately under their respective licenses
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version in a public repository under the MIT license; the free scope is the code of this version and does not mean external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercial use, and distribution of this version's code are permitted.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- Demo images, fonts, icons, and other third-party assets must be checked under their respective licenses and cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur separate charges.
View Original Text Basis
https://github.com/ANcRyel/fuwari-modified/blob/main/LICENSEhttps://github.com/ANcRyel/fuwari-modified/blob/main/README.mdPermission is hereby granted, free of charge
Original License Text
Compiled by DeepSeek based on repository license and README ·2026-10-02. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- More documented · 80 / 100
- Technologies
- Astro
- Website type
- Blog
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2026-10-01
- Screenshot last checked
- 2026-10-02
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Astro as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Automatically checked against source and license rules; no manual editorial review.
Inspect the recorded source material
SHA-256: 640fd77753f650bab9bb30e776b08263715135b1c9e3cdac42ec8fbcb874bf1c
2026-10-02T09:35:57.022Z
Source file / repository<div align="center"> <br/> <table> <tr> <td valign="middle" align="center"> # 🍥 Fuwari-Modified **基于 Fuwari 修改的 Astro 博客主题** *保持优雅 · 技术焕新 · 功能增强* </td> <td valign="middle" align="left"> [**🖥️ 在线预览**](https://ancryel.github.io/fuwari-modified-demo) [**📦 上游仓库**](https://github.com/saicaca/fuwari) [**🐛 提交反馈**](https://github.com/ancryel/fuwari-modified/issues) </td> </tr> </table> <br/> <table> <tr> <td valign="middle" align="center"> [](https://astro.build) [](https://alpinejs.dev) [](https://tailwindcss.com) [](https://www.typescriptlang.org) </td> <td valign="middle" align="center"> [](#) [](#) [](#) </td> </tr> </table> <br/> 📖 **README** · 简体中文 | [繁體中文](docs/README.zh-TW.md) | [English](README.en.md) <br/> </div> ---  > [!TIP] > 这是一款基于 [Astro](https://astro.build) 框架和 [Fuwari](https://github.com/saicaca/fuwari) 模板修改的博客主题。 > > 项目中许多内容是 AI 翻译,如有不准欢迎提交 [Pull Request](https://github.com/ancryel/fuwari-modified/pulls) 修正。 ## ✨ 功能特性 在保留 Fuwari 原版优雅设计与阅读体验的基础上,完成了以下修改与新增: ### 技术焕新 - [x] 升级至 Astro v5 - [ ] 升级至 Astro v7 - [x] Svelte 替换为 Alpine.js - [x] 升级至 Tailwind v4 - [ ] 升级至 TypeScript v6 ### 功能增强 - [x] 背景图 + 卡片透叠 - [x] 首页文字 - [x] 滚动进度条 ## 📖 使用说明 | 项目 | 路径 | |:---|:---| | 站点配置 | `src/config.ts` | | 文章 | `src/content/posts/` | | 关于页 | `src/content/spec/about.md` | > 更多内容(部署、主题定制、项目结构等)请参考 [原版 Fuwari README](https://github.com/saicaca/fuwari#readme)。 ## 🙏 特别致谢 一切基于 [saicaca](https://github.com/saicaca) 开发的 [fuwari](https://github.com/saicaca/fuwari) 模板。 ### 技术栈 Astro 5 · Alpine.js 3 · Tailwind CSS 4 · TypeScript 5.9 Pagefind · Expressive Code · KaTeX · PhotoSwipe · Swup ### 参考借鉴 - [fuwari](https://github.com/saicaca/fuwari), MIT 协议 - [Firefly](https://github.com/CuteLeaf/Firefly), MIT 协议 *(参考了首页文字功能)* - [Mizuki](https://github.com/matsuzaka-yuki/Mizuki), MIT 协议 *(参考了背景图 + 卡片透叠功能)* > `滚动进度条`功能的参考项目已找不到原始出处,如有知情者请[提交 Issue](https://github.com/ancryel/fuwari-modified/issues)告知。 ## 📄 许可协议 遵循 [MIT License](https://mit-license.org/) 开源协议。 - 原项目版权:Copyright (c) 2024 saicaca (Fuwari) - 修改部分版权:Copyright (c) 2026 ANcRyel (Fuwari-Modified) 详细条款见 [LICENSE](./LICENSE)。
Explore similar templates
Compare previews and descriptions within the same stack and category.

astrowind
AstroWind is a free, open-source Astro starter theme using Astro and Tailwind CSS, released under the MIT license.
Astro · Blog

astro-paper
AstroPaper is a minimal, responsive, accessible, and SEO-friendly Astro blog theme. Articles are stored as Markdown/MDX in src/content/posts/, with subdirectories affecting URLs.
Astro · Blog

fuwari
Fuwari is a static blog template built with Astro and Tailwind CSS for personal blogs. It manages posts as Markdown files in src/content/posts/, with frontmatter for title, date, description, cover, tags, categories, draft status, and language.
Astro · Blog

Firefly
Firefly is a clean personal blog theme forked from Astro and Fuwari, offering four background modes, single/double sidebar and list/grid layouts, Pagefind client-side full-text search, and a six-language UI.
Astro · Blog

astro-theme-cactus
Astro Cactus is an Astro-based blog and portfolio theme that uses Markdown/MDX content collections to manage posts, notes, and tags, with frontmatter type-checked by a schema.
Astro · Portfolio

astrofy
Astrofy is a free and open-source personal portfolio website template built with Astro and TailwindCSS, with built-in blog, CV timeline, project showcase, store, and RSS feed modules.
Astro · Portfolio
