AstroBlog

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.

3 previews
Desktop homepage1 / 3
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 3

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-02View source

What stands out

A quick read of the recorded project description.

01

An Astro blog theme modified from Fuwari, retaining the original page structure and reading experience

02

Upgraded to Astro v5 and Tailwind v4, with Alpine.js replacing the original Svelte

03

Added a visual treatment combining a background image with card overlay

04

Added homepage text display and a reading scroll progress bar

05

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.

AstroBlog

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. 1

    The README states Node.js >= 22 and pnpm >= 11; specific dependency versions are subject to the repository lockfile

  2. 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. 3

    More instructions on deployment, theme customization, and project structure require referring to the original Fuwari README

  4. 4

    The README notes that much of the project content is AI-translated and may contain inaccuracies

  5. 5

    Third-party assets such as demo images, fonts, and icons must be checked separately under their respective licenses

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This 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

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">

[![Astro](https://img.shields.io/badge/Astro-5.x-FF5D01?logo=astro&logoColor=white&style=for-the-badge)](https://astro.build)
[![Alpine.js](https://img.shields.io/badge/Alpine.js-3.x-8BC0D0?logo=alpinedotjs&logoColor=white&style=for-the-badge)](https://alpinejs.dev)
[![Tailwind CSS](https://img.shields.io/badge/Tailwind-4.x-06B6D4?logo=tailwindcss&logoColor=white&style=for-the-badge)](https://tailwindcss.com)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178C6?logo=typescript&logoColor=white&style=for-the-badge)](https://www.typescriptlang.org)

</td>
<td valign="middle" align="center">

[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D%2022-5FA04E?logo=nodedotjs&logoColor=white)](#)
[![pnpm](https://img.shields.io/badge/pnpm-%3E%3D%2011-F69220?logo=pnpm&logoColor=white)](#)

[![License](https://img.shields.io/badge/License-MIT-22c55e)](#)

</td>
</tr>
</table>

<br/>

📖 **README** · 简体中文 &nbsp;|&nbsp; [繁體中文](docs/README.zh-TW.md) &nbsp;|&nbsp; [English](README.en.md)

<br/>

</div>

---

![Preview Image](docs/preview.jpeg)

> [!TIP]
> 这是一款基于 [Astro](https://astro.build) 框架和 [Fuwari](https://github.com/saicaca/fuwari) 模板修改的博客主题。
>
> 项目中许多内容是 AI 翻译,如有不准欢迎提交 [Pull Request](https://github.com/ancryel/fuwari-modified/pulls) 修正。

## ✨ 功能特性

在保留 Fuwari 原版优雅设计与阅读体验的基础上,完成了以下修改与新增:

### &nbsp;&nbsp;技术焕新
- [x] 升级至 Astro v5
- [ ] 升级至 Astro v7
- [x] Svelte 替换为 Alpine.js
- [x] 升级至 Tailwind v4
- [ ] 升级至 TypeScript v6

### &nbsp;&nbsp;功能增强
- [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) 模板。

### &nbsp;&nbsp;技术栈

Astro 5 · Alpine.js 3 · Tailwind CSS 4 · TypeScript 5.9

Pagefind · Expressive Code · KaTeX · PhotoSwipe · Swup

### &nbsp;&nbsp;参考借鉴
- [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)。
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.