Getting Started

Firefly is a clean, beautiful, and modern personal blog theme built on the Astro framework and the Fuwari template. Designed for tech enthusiasts and content creators, it combines a modern web tech stack with rich feature modules and a highly customizable interface, enabling you to effortlessly create a professional and visually appealing personal blog.

Requirements

• Node.js 22.0 or higher
• pnpm package manager (recommended)
• Git

Installation

1. Clone the repository

git clone https://github.com/CuteLeaf/Firefly.git
cd Firefly

2. Install dependencies

pnpm install

3. Start the development server

pnpm dev

4. Build for production

pnpm build

Project Structure

Firefly/
├── src/
│   ├── config/          # Configuration files
│   ├── components/      # Components
│   ├── content/         # Content (posts, pages)
│   ├── layouts/         # Layout templates
│   ├── pages/           # Page routes
│   └── types/           # Type definitions
├── public/              # Static assets
└── astro.config.mjs     # Astro configuration

Configuration Overview

All configuration files are located in the src/config/ directory:

Config File	Description	Docs
siteConfig.ts	Site basic configuration	Site Config
navBarConfig.ts	Navbar configuration	Navbar
sidebarConfig.ts	Sidebar layout configuration	Sidebar
profileConfig.ts	Profile configuration	Profile
backgroundWallpaper.ts	Background wallpaper configuration	Wallpaper
commentConfig.ts	Comment system configuration	Comment
musicConfig.ts	Music player configuration	Music Player
fontConfig.ts	Font configuration	Font
coverImageConfig.ts	Cover image configuration	Cover Image
expressiveCodeConfig.ts	Code block configuration	Code Block
sakuraConfig.ts	Sakura effect configuration	Sakura
announcementConfig.ts	Announcement configuration	Announcement
footerConfig.ts	Footer configuration	Footer
licenseConfig.ts	License configuration	License
friendsConfig.ts	Friends links configuration	Friends
sponsorConfig.ts	Sponsor configuration	Sponsor
adConfig.ts	Advertisement configuration	Advertisement
pioConfig.ts	Live2D/Spine model configuration	Live2D/Spine