System Design Good Practices Library
A curated reference library for architects and engineering teams — covering patterns, principles, trade-offs, and implementation guidance across the full architecture landscape.
Browse by Category
Each section contains reference articles structured for fast lookup — with use cases, trade-offs, implementation notes, and decision checklists.
Architecture Foundations
Core principles, quality attributes, trade-off analysis, ADRs, and reference architectures that underpin every system design decision.
12 articlesArchitecture Styles
Monolith, microservices, event-driven, hexagonal, CQRS, event sourcing, serverless, and more — with deep comparisons and when to apply each.
14 articlesDistributed Systems
Sagas, consensus algorithms, distributed locking, leader election, vector clocks, and partition tolerance for multi-node architectures.
14 articlesCommunication Patterns
Request-response, pub/sub, message queues, event streaming, webhooks, fan-out, and brokered integration patterns.
14 articlesReliability & Resilience
Retries, circuit breakers, bulkheads, dead letter queues, chaos engineering, and exactly-once delivery semantics.
14 articlesScalability & Performance
Horizontal and vertical scaling, caching strategies, sharding, rate limiting, connection pooling, and materialized views.
14 articlesAPI & Interface Design
REST, GraphQL, gRPC, API versioning, gateways, BFF pattern, OpenAPI, pagination, idempotency keys, and contract testing.
14 articlesIntegration Patterns
ESB, canonical data models, anti-corruption layers, CDC, ETL/ELT, orchestration vs choreography, and file-based integration.
10 articlesData Architecture
Relational, NoSQL, document, graph, and time-series databases. Data lakes, warehouses, lakehouses, and schema evolution.
15 articlesSearch & Retrieval
Full-text search, relevance ranking, faceted search, semantic search, vector search, and hybrid retrieval architectures.
8 articlesSecurity Architecture
Authentication, authorization, zero trust, OAuth2, secrets management, encryption, WAF, supply chain security, and compliance.
14 articlesObservability & Operations
Logging, metrics, tracing, alerting, SLOs, dashboards, runbooks, incident management, and feature flags.
11 articlesDeployment & Delivery
CI/CD, blue-green, canary, rolling, progressive delivery, IaC, GitOps, database migrations, and rollback strategies.
10 articlesCloud Architecture
Landing zones, multi-region, active-active/passive, cloud networking, service mesh, Kubernetes, FinOps, and autoscaling.
12 articlesPlatform Engineering
Internal developer platforms, golden paths, self-service infrastructure, service catalogs, and policy as code.
7 articlesSoftware Engineering Practices
Clean architecture, DDD, SOLID, TDD/BDD, contract testing, refactoring strategy, code review standards, and dependency management.
10 articlesMobile Architecture
MVC/MVP/MVVM, offline-first, sync engines, push notifications, mobile API design, and app lifecycle management.
6 articlesIoT & Edge
Device identity, telemetry ingestion, edge processing, device management, and IoT protocol selection.
5 articlesBig Data & Analytics
Batch processing, stream processing, data pipelines, data quality, BI/reporting, feature stores, and lakehouse governance.
7 articlesAI & ML Systems
Model training pipelines, model serving, RAG architecture, vector databases, prompt management, AI guardrails, and observability.
9 articlesGovernance & Enterprise Standards
Technology standards, exception management, architecture review boards, documentation standards, and risk management.
7 articlesAnti-Patterns
Common architectural mistakes — distributed monoliths, big ball of mud, chatty services, premature optimization, and more.
9 articlesDecision Guides
Structured comparisons for common architectural choices: SQL vs NoSQL, REST vs GraphQL, monolith vs microservices, and more.
10 guidesTemplates
ADR templates, system design review checklists, production readiness checklists, threat modeling templates, and more.
9 templatesHow to use this library
Lookup by Problem
Use the search bar or browse by category to find patterns for the problem you're solving right now.
Compare Trade-offs
Every article includes a pros/cons analysis and a decision checklist to support structured trade-off discussions.
Use the Templates
Grab a ready-to-use ADR template, production readiness checklist, or threat model template from the Templates section.
Use Decision Guides
When facing common architectural forks (e.g. REST vs GraphQL), consult the Decision Guides for structured comparison.
Every article follows the same structure
Consistent format makes it easy to quickly find the information you need.