A collection of system design projects and templates that turn vague ideas into structured, reviewable designs. Each project follows the same flow: define requirements, outline architecture, dive into trade-offs, and capture decisions in a consistent, reusable format.

This repository helps you move from "I have an idea" to "I have a design" faster, with clear artifacts you can share with teammates, interviewers, or future you.

• Provides a repeatable framework for capturing functional and non-functional requirements.
• Encourages explicit trade-offs and assumptions so designs are defensible.
• Stores designs as modular projects so you can compare patterns across domains.
• Makes it easy to extend with new case studies using the same structure.

• Speeds up design thinking with a structured template.
• Improves communication by documenting decisions in one place.
• Creates a portfolio of system design work that is easy to review and evolve.

• email-service-provider/ - Full project: requirements, architecture, deep dives, and assets.
• framework/ - Reusable template for new system design projects.

flowchart LR
  A[Problem] --> B[Requirements]
  B --> C[High-Level Design]
  C --> D[Deep Dives]
  D --> E[Trade-offs]
  E --> F[Final Doc]

1. Copy the template from framework/ into a new project folder.
2. Rename the folder and update the readme.md with your problem statement.
3. Fill in requirements and iterate on the design artifacts.

• Establish a reusable design template
• First case study: Email Service Provider
• Add more case studies (payments, search, analytics, etc.)
• Cross-project comparison notes and common patterns

• Problem statement
• Functional requirements
• Non-functional requirements
• High-level architecture
• Deep dives and trade-offs