Project structure, design patterns, API contracts, scalability

Software architecture guidance covering project structure conventions, design patterns catalog, API contracts and versioning, scalability trade-offs, and monolith vs microservices.

Resource files

project-structure-conventions.md

Laying out folders, monorepo vs polyrepo

design-patterns-catalog.md

Deciding whether a pattern (DI, repository, strategy, observer) fits

api-contracts-and-versioning.md

Breaking-vs-compatible change policy, deprecation

scalability-and-tradeoffs.md

Deciding if/how to scale, avoiding premature scaling

monolith-vs-microservices.md

Deciding whether to split a service