Frontmatter reference
Frontmatter is the YAML block between --- lines at the top of every article.
---
title: Building Romyq
description: Why I built an autonomous project manager.
date: 2026-07-12
updated: 2026-07-15
tags:
- rust
- ai
- productivity
published: true
cover: ./images/cover.webp
---
Fields
| Field | Required | What it does |
|---|---|---|
title | yes | Article title. Shown on the page, cards, feeds, and <title>. |
description | yes | One-or-two-sentence summary. Used on cards, meta description, OpenGraph, and search results. |
date | yes | Publication date (YYYY-MM-DD). Controls ordering everywhere. A future date keeps the article hidden until that day. |
updated | no | Last-revision date. Shown next to the publish date and used in JSON-LD / sitemap. |
tags | no | List of plain strings. Each tag automatically gets a page at /tags/<tag>/. |
published | no | Defaults to true. Set false and the article is never built — it appears nowhere on the production site. |
cover | no | Path to a cover image relative to the article, e.g. ./images/cover.webp. Shown on the article, on cards, and used as the OpenGraph image. |
Rules worth remembering
- The date comes from frontmatter, never from the filename or folder. The folder (
content/2026/07/) only determines the URL. Keep them consistent for sanity, but changingdate:does not move the URL — so links never break. - Tags are just strings. Reusing an existing tag (check
/tags/) groups articles together; a new string creates a new tag page automatically. - Keep descriptions real. They are what people see on the homepage, in search results, and when the link is shared.
titleanddescriptioncontaining a colon should be quoted:title: "Rust: the good parts".