The Setup
This site runs on Hugo (v0.155.1 extended) with the github-style theme. It’s deployed automatically to GitHub Pages
via GitHub Actions
whenever I push to the main branch. Simple, fast, and developer-friendly.
But here’s where it gets interesting: I’m not writing most of the code myself. Instead, I’m collaborating with AI.
Claude: The Architect
When I need to make structural changes—like adding a new Tutorials section, creating custom layouts, or overhauling the navigation—I turn to Claude. Claude doesn’t just write code; it understands context. I can describe what I want in plain English, and it generates Hugo templates, updates multiple files, and even explains what it changed and why.
For example, when I wanted to create a “Popular Content” section on the homepage that pulls from both Posts and Tutorials, I simply asked. Claude:
- Updated the
overview.htmlpartial to combine both content types - Limited the display to the 2 most recent items
- Added metadata (content type, tags, creation date) to each item
- Used relative URLs throughout
All in one go. No trial and error. No hunting through Hugo documentation for hours.
Copilot: The Helper
While Claude handles the big architectural decisions, GitHub Copilot lives in VS Code and helps with the smaller stuff—autocompleting function names, suggesting HTML structures, and filling in repetitive patterns. It’s like having a pair programmer who knows what you’re about to type before you do.
Copilot really shines when I’m writing Markdown content or tweaking CSS. It’ll suggest entire paragraphs, code blocks, or style rules based on the context of what I’m working on. It’s not perfect, but it’s fast, and it keeps me in the flow.
The Workflow
Here’s how a typical session looks:
- I describe what I want to Claude in natural language
- Claude generates the code, often touching multiple files at once
- I review the changes and test locally with
hugo server -D - Copilot assists with tweaks as I refine details
- I push to GitHub, and the site updates automatically
It’s collaborative, iterative, and surprisingly efficient.
What This Means
I’m not a Hugo expert. I don’t have every template syntax memorized. But I don’t need to be. The AI handles the boilerplate, the cross-file coordination, and the “how do I do this in Hugo” questions. I focus on what I want the site to do, and the tools figure out the how.
This isn’t about replacing developers. It’s about amplifying what we can do. I’m building faster, experimenting more, and spending less time stuck on implementation details.
The Results
In the time it would have taken me to manually set up one new section, I’ve:
- Created a complete Tutorials section with custom archetypes and layouts
- Overhauled the navigation system
- Standardized all URLs to be relative
- Built a dynamic “Popular Content” section
- Written two blog posts (including this one)
All with AI assistance. All in a matter of hours.
What’s Next?
I’m just getting started. The site works, the content is live, and I’m learning how to work with AI as a creative tool—not just a code generator. There’s still plenty to explore:
- Using AI to help generate tutorial content
- Automating SEO optimizations based on suggestions
- Creating custom theme modifications based on natural language descriptions
The future of web development isn’t about memorizing syntax. It’s about describing what you want and having the tools to make it happen. And that future is already here.
If you’re building something and haven’t tried working with AI yet, I’d recommend giving it a shot. You might be surprised at how much it changes the way you work.
