June 20, 2026
How I write posts on this site
- meta
- guide
A note to my future self on how to add a post.
1. Create the file
Add a new file under content/blog/, named with the URL slug you want:
content/blog/my-new-post.mdx
That file becomes https://elroykimbi.dev/blog/my-new-post.
2. Add frontmatter
Every post starts with a frontmatter block:
---
title: "My new post"
date: "2026-06-24"
summary: "One sentence shown in the post list and search results."
tags: ["engineering"]
---
3. Write in Markdown / MDX
Everything below the frontmatter is normal Markdown. Because it's MDX, you can also drop in React components when you want something interactive.
4. Publish
Commit and push — the post is live on the next deploy. That's it.