Featured projects
Showcase your best work at the top of your homepage by marking projects as featured.
Highlight your best work
When you have many projects, you'll want to show your best ones first. The featured flag does exactly that — it moves selected projects to the top of your homepage in a dedicated "Featured" section.
How to feature a project
Add featured: true to any project's frontmatter:
---
title: "My Best Project"
description: "Award-winning website design"
featured: true
---
Project description here...
What happens
- ✅ Project moves to the top of your homepage
- ✅ Creates a dedicated "Featured" section
- ✅ Maintains all other project functionality
- ✅ Works with categories, tags, and custom colors
- ✅ Preserved during static export
Combine with other features
Featured projects work seamlessly with all other metadata:
---
title: "Award-Winning Website"
description: "Complete redesign for Fortune 500 company"
featured: true
year: "2024"
category: "web-design"
client: "Major Corporation"
tags: ["responsive", "e-commerce", "award-winner"]
color: "#1a1a2e, #ffffff"
---
Best practices
- Be selective — Feature only your absolute best 3-5 projects
- Update regularly — Rotate featured projects to keep your homepage fresh
- Mix categories — Show range by featuring projects from different categories
- Add context — Featured projects should have compelling descriptions
Remove featured status
Simply remove the line or set it to false:
---
title: "Regular Project"
featured: false
---
Projects without the featured flag (or with featured: false) appear in the regular project grid below the featured section.