Writing

Architecture, with the sources attached

Domain-driven design and clean architecture get quoted a lot and read very little. These posts go back to the primary sources — Evans, Cockburn, Palermo, Martin, Fowler, Vernon, and the NestJS, Prisma and TypeORM docs — and turn them into decisions you can make about modules, directories, and files.

July 29, 202610 min readStructure That Survives · Part 1
The Dependency Rule, From the Source
Hexagonal, Onion, and Clean Architecture are three drawings of one rule. Here is what each author actually wrote, and what the rule costs you in a real NestJS codebase.
clean architecturehexagonalnestjstypescriptbackend
July 26, 20269 min readStructure That Survives · Part 2
DDD Building Blocks, On Disk
Bounded contexts, aggregates, repositories and services are usually explained as diagrams. This is what each one is supposed to be — quoted from Evans, Fowler and Vernon — and the NestJS folder it turns into.
dddaggregatesbounded contextnestjstypescript
July 22, 20268 min readStructure That Survives · Part 3
Package by Feature, Not by Layer
Why controllers/, services/, repositories/ stops working in a NestJS codebase, what feature modules actually give you that folders cannot, and a directory tree you can copy — plus the lint rules that keep it honest.
file structurenestjsmonoreponxtypescript
July 18, 202610 min readStructure That Survives · Part 4
Everything That Isn't Code: Assets, Migrations, Config and Uploads
Where templates, SQL, static files, secrets and user uploads belong in a NestJS repository — with the nest-cli asset globs, migration rules, cache headers and presigned-URL limits quoted from the docs.
assetsnestjsmigrationsconfigs3docker

The Dependency Rule, From the Source

DDD Building Blocks, On Disk

Package by Feature, Not by Layer

Everything That Isn't Code: Assets, Migrations, Config and Uploads