← All posts

June 20, 2026

How I write posts on this site

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.