Alireza Afshan
AboutProjectsBlogResume

April 18, 2026 / B♥

Building a File-Based Personal Site

Why a small personal site does not need a full CMS to feel maintainable.

B♥
Blog
♥B
take me back
#Site#Markdown#Workflow

For a personal site, the simplest workflow is usually the best one.

If content lives in markdown files, the editing model is easy to understand:

  1. write or update a file
  2. commit the change
  3. push it
  4. let CI deploy the site

That keeps the content versioned alongside the code and avoids introducing a second system just to publish a few projects or posts.

It also makes it easier to refactor the front end later, because the content stays portable.

B♥ / Under Construction

Still wiring this page together

The blog archive is getting polished up. The rest of the site is open while this corner stays behind the caution tape.

Alireza Afshan 2026

mail@alirezaafshan.com