Firestar — 一款清新美观的 Astro 博客主题

什么是 Firestar？#

Firestar 是一款基于 Astro 框架和 Fuwari 模板开发的清新美观且现代化个人博客主题，专为技术爱好者和内容创作者设计。

该主题融合了现代 Web 技术栈，提供了丰富的功能模块和高度可定制的界面，让您能够轻松打造出专业且美观的个人博客网站。

✨ 核心特性#

🎨 精美设计#

清新现代的 UI 设计，支持亮色/暗色主题自动切换，响应式布局完美适配桌面端和移动端。

🖼️ 图片画廊#

内置相册功能，支持瀑布流布局展示图片集。

🛠️ 技术栈#

• Astro 7 — 静态站点生成框架
• Svelte 5 — 交互式 UI 组件
• Swup.js — 页面切换动画（SPA 体验）
• Tailwind CSS — 原子化 CSS 样式
• Pagefind — 静态全文搜索
• Biome — 代码格式化与检查

📦 快速开始#

环境要求： Node.js >= 22，包管理器推荐 pnpm

1
# 克隆项目
2
git clone https://github.com/wind-001/Firefly.git
3
cd Firefly
4

5
# 安装依赖
6
pnpm install
7

8
# 启动开发服务器
9
pnpm dev

访问 http://localhost:4321 即可预览。

1
# 构建生产版本
2
pnpm build
3

4
# 预览构建结果
5
pnpm preview

构建产物在 dist/ 目录，可部署到任何静态托管平台。

🚀 部署方式#

Firestar 支持多种部署方式：

• Cloudflare Pages — 推荐，支持 GitHub 自动部署
• Vercel — 一键部署，配置简单
• Netlify — 静态托管首选
• Cloudflare Workers — 边缘计算部署

⚙️ 高度可配置#

所有功能都通过 src/config/ 目录下的 TypeScript 文件进行配置：

• siteConfig.ts — 站点基本信息、主题设置
• sidebarConfig.ts — 侧边栏布局
• navBarConfig.ts — 导航栏菜单
• profileConfig.ts — 作者信息
• commentConfig.ts — 评论系统配置
• friendsConfig.ts — 友链配置

无需修改代码，只需调整配置文件即可个性化你的博客。

📚 更多资源#

• 在线预览：Firefly Demo
• 使用文档：Firefly 文档
• 开源地址：CuteLeaf/Firefly

📄 开源协议#

本项目基于 MIT 协议开源，您可以自由使用、修改和分发。

Firestar — 让每一片叶子都能闪耀 ✨