https://notes.burelli.xyz/tags/project-structure/Recent content in Project-Structure on Buro notesHugoen-usSun, 25 Oct 2026 03:19:43 +0100https://notes.burelli.xyz/posts/engineering/code-design-and-architecture/organize-by-feature/Sun, 25 Oct 2026 02:57:28 +0100https://notes.burelli.xyz/posts/engineering/code-design-and-architecture/organize-by-feature/<h1 id="organize-code-by-feature-not-by-type">Organize code by feature, not by type</h1> <p>Every project needs a folder structure: backend, frontend, CLI, any software. There are two ways to split files:</p> <ul> <li><strong>by type</strong>: models in one folder, controllers in another, tests in a third;</li> <li><strong>by feature</strong>: everything about one feature in one folder.</li> </ul> <p>My rule: <strong>always organize by feature</strong>. This post explains why, with an example tree and the special case of the &ldquo;utilities&rdquo; folder.</p> <h2 id="the-bias-the-windows-xp-home-folder">The bias: the Windows XP home folder</h2> <p>Many of us learned to organize files here:</p>