2 min read
Projects Collection

The projects collections is found in src/content/projects.

Working with the projects collection:

πŸ“ /src/content/projects
└── πŸ“ project-1
      └── πŸ“„ index.md
└── πŸ“ projects-2
      └── πŸ“„ index.mdx

In the above example, two static pages will be generated, based on the existence of a classic markdown .md file or a jsx compatible markdown .mdx file. The folder name represents the slug:

  • https://example.com/projects/project-1
  • https://example.com/projects/project-2

All content must be preceded by required metadata in the markdown file in yaml format, and be enclosed by triple dashes. --- ---

---
title: "My awesome project"
description: "A description of my project."
date: "Mar 22 2024"
draft: false
---

Metadata fields

FieldReqTypeRemarks
titleYesstringTitle of the content. Used in SEO and RSS.
descriptionYesstringDescription of the content. Used in SEO and RSS.
dateYesstringMust be a valid date string (able to be parsed).
draftNobooleandraft: true, content will not be published.
demoURLNostringLink to live project demo, if applicable.
repoURLNostringLink to project repo, if applicable.

All that’s left to do is write your content under the metadata.

---
title: "My awesome project"
description: "A description of my project."
date: "Mar 22 2024"
draft: false
---

### Woot

This is a paragraph about my project.

πŸŽ‰ Congrats, you are now a blogger, and developer.