Video failed to load

Example Project

Back to projects
Example Project
Planning
Documentation/Guides

This document explains project collection frontmatter fields and status values for writing projects in src/content/projects/.

Project Page Guide#

Create a project by adding a .md or .mdx file under src/content/projects/. The body serves as the project README and appears at the bottom of its detail page. Frontmatter fields populate the listing card and the top of the detail page.

Frontmatter Fields#

FieldTypeDescription
titlestringRequired. Project name.
slugstringOptional. Used in the same way as post slugs.
publisheddateRequired. Publication or update date, such as 2025-10-01. Used for sorting together with order.
draftbooleanOptional; defaults to false. When true, the page is hidden in production builds but visible in development.
ordernumberOptional. Manual sort weight: higher values appear first. When omitted, projects are sorted by published in descending order.
descriptionstringOptional. Card summary and detail-page description.
imagestringOptional. Cover image. Supports full URLs, public root paths (/images/xxx.png), and paths relative to this file, such as images/xxx.png. Leave empty to omit the cover.
tagsstring[]Optional. Tags displayed as #tag on listing and detail pages.
linkarrayOptional. External-link buttons: { label, icon, value }. Use an astro-icon name such as fa7-brands:github, an image URL, or leave icon empty to use the first letter of label.
statusstringOptional. Project status using a standard key listed below.
langstringOptional. Page language, such as zh_CN.

Complete Example#

---
title: "Firefly"
slug: firefly
published: 2025-10-01
draft: false
order: 100
description: "一个功能丰富的开源博客主题。"
image: "images/firefly.avif"
status: "published"
tags:
- Astro
- Svelte
link:
- label: "GitHub"
icon: "fa7-brands:github"
value: "https://github.com/CuteLeaf/Firefly"
- label: "文档"
icon: "material-symbols:menu-book"
value: "https://docs-firefly.cuteleaf.cn"
lang: ""
---

Status Keys (status)#

Use a standard key for status. The interface displays a localized label in the site language and automatically assigns a color and icon:

keyMeaningLocalized example
planningPlanningPlanning
developingIn DevelopmentIn Development
publishedPublishedPublished
archivedArchivedArchived
  • Specify only the standard key: status: "published".
  • Unknown or custom strings are displayed unchanged in neutral gray and are excluded from the listing page’s status filters.

The listing page supports filtering by status (all or an individual status) and searching project names, descriptions, and tags.

Profile Image of the Author
BingYun
Hello, I'm BingYun
Tags
Table of Contents