Skip to content

Awesome ArchitectureThink like an architect

Writing code is disappearing; judgment is what's getting valuable. 34 architecture-thinking chapters + 26 real-system architecture maps + 6 end-to-end cases — architecture only, no syntax.

Fully bilingual. All 34 tutorial chapters, 26 templates, and the first 6 cases are available in English — use the language switch (top-right) or browse en/ in the repo. Contributions welcome.

🗺️ Browse all 26 architecture maps

Click a category to filter, then click any card to jump to that template's architecture map.

🤖
AI Chat Product
LLM inference · streaming · context · cost
General
🧩
Browser Extension
Content/background split · injection · privacy
General
🌐
Standard Web App
Three-tier · caching · read/write split
General
📱
Mobile App
Offline-first · sync · push
General
🛒
E-commerce Platform
Inventory · orders · overselling · spikes
General
📰
Social Feed
Feed push/pull · follow graph · fan-out
General
🎬
Video Streaming
Transcoding · CDN · adaptive bitrate
General
💬
Realtime Chat
Long-lived conns · ordering · offline delivery
General
🔗
URL Shortener
Read-heavy · redirect · unique ID
General
💳
Payment System
Idempotency · double-entry · reconciliation
General
🔍
Search Engine
Inverted index · recall + rerank
General
🚗
Ride-Hailing
Geo index · realtime matching
General
📝
Collaborative Doc
OT/CRDT · single-writer serialization
General
☁️
Cloud Storage
Chunking · dedup · incremental sync
General
🔔
Notification System
Multi-channel fan-out · dedup/throttling
General
🎫
Online Ticketing
Waiting room · atomic decrement · seat lock
General
🚪
AI Gateway / Relay
Unified API · billing · load balancing
AI
📚
RAG Knowledge Base
Chunking · vector retrieval · rerank
AI
🤹
AI Agent / Workflow
Action loop · tools · memory
AI
Inference Serving
Continuous batching · paged KV
AI
🧭
Vector Database
ANN · HNSW · similarity search
AI
🖥️
Claude Code
Local-first coding · subagents/hooks/MCP · two-tier perms
Agent
🛰️
OpenAI Codex
Local CLI + cloud sandbox · async PRs · two-axis safety
Agent
🦞
OpenClaw (the lobster)
Self-hosted gateway · chat as UI · always-on
Agent
🧠
Hermes
FTS5 memory · auto-distilled skills · always-on
Agent
📜
System Prompt Architecture
Layered Agent OS · routing · compliance
Prompt

🧪 Read the first 6 cases

The case track is not more templates. It is a full product walkthrough: starting architecture, quantified trigger signals, ADRs, data flow, failure fallbacks, and quick checks. 👉 Enter the case track

🧰 Learn technology stack selection

The new technology stack selection track (27–34) is not a framework tutorial. It teaches the architectural judgment behind language, databases, cache, APIs, deployment, observability, and AI infrastructure. 👉 Start from Chapter 27

⚖️ Architecture is a series of forks in the road

The most valuable section of every template is "Key Decisions & Trade-offs." Try this interactive starter:

⚖️Monolith or Microservices?
Monolith
One deployable unit, in-process function calls. Simple, debuggable, light on ops.
VS
Microservices
Multiple independently deployed services calling each other over the network. Independent scaling and release, but you inherit the full burden of distributed systems.

🤔 First, a warm-up

Before diving in, check your gut sense of 'architecture':

🤔Which of the following is closest to the essence of 'architecture'?
  • AA diagram with a few boxes connected by lines
  • BA set of decisions that are hard to change, cross-cutting, and decide quality attributes
  • CJust use the newest frameworks and microservices

Ready? 👉 Start from Chapter 01, or browse 26 architecture maps on GitHub.