Hello World
Welcome to my blog. This is where I'll share thoughts on software engineering, architecture decisions, and lessons learned along the way.
Why a blog?
Background
Writing forces clarity. When I can explain an idea in plain language, I know I actually understand it. This blog is that exercise made public — a place to think out loud about the craft of building software.
What to expect
Posts will cover topics like:
- Architecture patterns — trade-offs I've seen in real systems
- Developer experience — tools, workflows, and ergonomics that matter
- Career reflections — things I wish I'd known earlier
How this blog is built
Stack overview
This site runs on Next.js with MDX for content. Blog posts are plain .mdx files with YAML frontmatter, rendered server-side via next-mdx-remote.
const { content, data } = matter(source);
// data = { title, date, excerpt }
// content = raw MDX string passed to <MDXRemote />Why MDX over a CMS
I wanted posts to live in the repo alongside the code. No external dependencies, no API calls at build time, no sync issues. If the repo is the source of truth for the app, it should be the source of truth for the content too.
Custom components
Each post can use styled section components — Code, Context, Heuristics, and Lessons — passed to MDX at render time:
<MDXRemote source={content} components={mdxComponents} />Takeaways
- Writing about your work sharpens your thinking about it
- MDX gives you the simplicity of markdown with the power of React components
- A TLDR toggle is a small thing that respects the reader's time
Stay tuned.