Overview #
This site itself is a project worth documenting. It’s a statically generated portfolio and blog built with Hugo and the Blowfish theme, designed to be fast, minimal, and easy to maintain.
The goal: a place to document my projects, write about things I’m working through, and have a corner of the internet that’s mine — without the overhead of managing a CMS or a server.
Why Hugo #
- Fast builds — Hugo compiles in milliseconds
- No runtime dependencies — the output is pure HTML/CSS/JS
- Markdown-first — writing content is just writing markdown files
- Blowfish theme — modern, Tailwind-based, well-documented
Static sites make sense here. There’s no dynamic content, no user authentication, nothing that requires a server. The output can be deployed to any CDN.
Stack #
- Static site generator: Hugo
- Theme: Blowfish (Tailwind CSS)
- Color scheme: Ocean (dark mode default)
- Hosting: TBD (GitHub Pages / Cloudflare Pages / Netlify)
Structure #
content/
├── about/ # About page
├── projects/ # Portfolio projects (this is one of them)
└── blog/ # Blog postsEach project is a self-contained directory with an index.md — this makes it easy to add images, data files, or other assets alongside the content.
Customization #
The main customization over the default Blowfish theme:
- Navigation: Projects, Blog, About
- Homepage layout: Profile with custom headline
- Dark mode default with auto-switching
- Card view on project listing
What I’d Do Differently #
- Set up the content structure before touching config — I spent time debugging broken menu links that just needed the right directory to exist
- Decide on the URL structure early (e.g.
/projects/vs/work/) before writing content