Solution Architecture References Library

A curated reference library for architects and engineering teams — covering patterns, principles, trade-offs, and implementation guidance across the full architecture landscape.

Overview

This is a static HTML site containing 200+ articles organized into 24 categories. Every article follows a consistent structure: what it is, why it exists, when to use / not use, typical architecture, pros/cons, implementation notes, failure modes, decision checklist, example use cases, related patterns, and further reading.

Structure

Section	Category	Articles
1	Architecture Foundations	12
2	Architecture Styles	14
3	Distributed Systems	14
4	Communication Patterns	14
5	Reliability & Resilience	14
6	Scalability & Performance	14
7	API & Interface Design	14
8	Integration Patterns	10
9	Data Architecture	15
10	Search & Retrieval	8
11	Security Architecture	14
12	Observability & Operations	11
13	Deployment & Delivery	10
14	Cloud Architecture	12
15	Platform Engineering	7
16	Software Engineering Practices	10
17	Mobile Architecture	6
18	IoT & Edge	5
19	Big Data & Analytics	7
20	AI & ML Systems	9
21	Governance & Enterprise Standards	7
22	Anti-Patterns	9
—	Decision Guides	10
—	Templates	9
—	Diagram Library	—
—	Glossary	—

Usage

Open index.html in a browser, or serve the folder with any static file server:

# Python
python3 -m http.server 8080

# Node.js (npx)
npx serve .

Then navigate to http://localhost:8080.

How to Use the Library

• Lookup by Problem — Use the search bar or browse by category to find patterns relevant to your current problem.
• Compare Trade-offs — Every article includes a pros/cons analysis and decision checklist for structured trade-off discussions.
• Use Templates — Grab ready-to-use ADR templates, production readiness checklists, or threat model templates from the Templates section.
• Decision Guides — For common architectural forks (e.g. REST vs GraphQL, SQL vs NoSQL), consult the Decision Guides for structured comparisons.

Assets

• assets/css/ — Stylesheets (light/dark theme, responsive layout)
• assets/js/ — Search, theme toggle, reading progress, and navigation scripts