A personal blog built on the Frosti theme — clean, fast and focused on content. This repository hosts the source of "Shepherd's Blog" and is customized from the open-source Frosti template.

• Theme: Frosti (kept as upstream base)
• Site title: Shepherd's Blog
• Purpose: Personal blog and notes

Note: During cleanup I removed archival backup images and some large historical assets to reduce repository size. You can find a snapshot branch pre-cleanup-backup in case you need to restore anything.

1. Install dependencies:

pnpm install

2. Run development server:

pnpm run dev

3. Build for production:

pnpm run build

• src/ — site source, components, pages
• content/ — markdown posts and pages
• public/ — static assets served by the site
• scripts/ — utilities (backup scripts were removed)

• Removed image-backup/ (archival images)
• Removed scripts/backup-images.ps1 and frosti.update.sh
• Removed public/resources/pdf/ files
• Historical large files (e.g. Vercel build artifacts, docs images) will be purged from Git history after your confirmation

This project is built on top of the open-source Frosti theme. Thanks to its authors and contributors.

If you'd like, I can continue and:

• Rewrite more README text to match your personal blog copy and links, or
• Proceed to scrub history (remove large files from git history) — this requires a force-push and coordination.

Tell me how you want the README copy refined (author name, blog links, short bio, features to highlight) and whether I should proceed with history rewrite now.

🖥️ Frosti Demo   /   🌏 Chinese README   /   ❤️ My Blog

• ✅ Light / Dark mode available
• ✅ Super fast performance with excellent SEO
• ✅ View transition animations (using ClientRouter)
• ✅ Search functionality for your articles (using Pagefind)
• ✅ Responsive design built with Tailwind CSS and daisyUI
• ✅ RSS feed support
• 🛠️ Easy to use blog
  • Customize your blog content in frosti.config.yaml

1. Install pnpm package manager (if you haven't already)

npm i -g pnpm

2. Clone the project

git clone https://github.com/EveSunMaple/Frosti.git Frosti

3. Enter the project folder

cd Frosti

4. Install dependencies

pnpm i

On first run or after updating content, execute search:index to generate the search index:

# Generate the search index for development use
pnpm run search:index

pnpm run dev

Frosti uses frosti.config.yaml as its configuration file, where you can configure the website's basic information, navigation bar, footer, and more.

site:
  tab: Frosti # Text displayed in the browser tab
  title: Frosti # Website title
  description: A clean, elegant, and fast static blog template! # Website description for SEO
  language: en # Website language code, e.g., "en" for English, "zh" for Chinese
  favicon: /favicon.ico # Website favicon path

theme:
  light: winter # Light mode theme, based on daisyUI themes
  dark: dracula # Dark mode theme, based on daisyUI themes
  code: github-dark # Code block theme style

• Themes are based on options provided by daisyUI
• Code block themes use styles from Shiki

date_format: ddd MMM DD YYYY # Date display format

menu:
  - id: home # Unique identifier for the menu item
    text: Home # Text displayed in the menu
    href: / # Link address
    svg: "material-symbols:home-outline-rounded" # Icon
    target: _self # Link target

Each menu item includes the following properties:

• id: Unique identifier
• text: Displayed text
• href: Link address
• svg: Icon code using Iconify icon set
• target: Link target (_self for current window or _blank for new window)

You can configure sub-menu items by adding subItems with the same format as main menu items.

user:
  name: EveSunMaple # Username
  site: "https://example.com" # User website
  avatar: /profile.png # User avatar

Sidebar and footer can have different social media links:

sidebar:
  social:
    - href: "https://github.com/username" # Link address
      ariaLabel: Github # Accessibility label
      title: Github # Tooltip on hover
      svg: "ri:github-line" # Icon code

Frosti uses Iconify as its icon library. You can search for icons you like on their website, then copy the icon code to the svg field in the configuration file.

Frosti supports multiple languages, configured through:

1. Setting the default language in frosti.config.yaml:

site:
  language: en # Set to "en" for English, "zh" for Chinese

2. Managing all interface text translations in the src/i18n/translations.yaml file:

en: # English translations
  label:
    noTag: No tags assigned
    tagCard: Tags
    # Other English labels...

zh: # Chinese translations
  label:
    noTag: 未分配标签
    tagCard: 标签
    # Other Chinese labels...

To add new language support or modify existing translations:

1. Add a new language code and corresponding translations in the translations.yaml file, or modify existing translations
2. Change site.language in frosti.config.yaml to your preferred language code

To keep your project up to date with the latest version of Frosti, you can use the provided update script.

bash frosti.update.sh

This script will:

1. Clone the latest version of the Frosti repository.
2. Safely update your project files, adding and overwriting files based on the .updateignore file.
3. Intelligently delete files that have been removed from the official repository, without affecting your ignored files.
4. Clean up any remaining empty folders and temporary files.
5. Install or update dependencies using pnpm.

If you have any questions or suggestions, you can provide feedback or communicate with the developer by submitting Issues!

@Saicaca Their inspiration was the main reason I created this theme

@WRXinYue They helped me a lot when I was first getting started