Your Folder Structure Is an Interface
12 Aug 2026
31 min read
On this page
- Bad structure never throws an error
- The destination, and the part nobody tells you
- Folders by kind lose to folders by purpose
- Own by imports, not by layout
- Names that lie cost more than names that are vague
- Make the URL tree answer the same question as the folder tree
- How to actually move
- Conventions that aren't machine-checked rot
- The honest numbers
- Two things the plan didn't predict
- Why this pays double when agents are writing the code
- The question worth asking
More Articles
The Evolution of Web Development
Isomorphic JavaScript, SSR, Hydration, and Resumability
Read article
Building Limited Session — A Mac Menu-Bar App For Eye Strain
After 12+ years as a software dev, eye strain got bad enough that I genuinely thought my career was over. This is the story of the tool I built to keep myself on the 20-20-20 rule — what worked, what didn't, and why a menu-bar app beats every Pomodoro timer I've tried.
Read article
How to work with Git Submodules
Various scenarios are covered to give a complete overview of Git Submodules
Read article
Overview of HTTP/1.1 Waterfall and HTTP/2 multiplexing
Why HTTP/1.1 leads to waterfall and how HTTP/2 solves it
Read article