System Design Handbook · llms.txt
The System Design Handbook is a free, open-source course in system design. It teaches how large software systems are built: how they stay fast, how they survive failures, and how they grow from one server to millions of users. It also prepares you for the system design interview, where you're asked to design such a system out loud in about 45 minutes.
Every chapter is written for this site in plain language, and each one lists the sources it draws on under "Further reading". If you're new, start with How to use this handbook.
The flashcards help you remember what you've read. They use spaced repetition: a card you answer easily comes back after a longer gap, and a card you miss comes back soon. Reviewing a few minutes a day this way is enough to keep the key ideas fresh.
The scheduler works much like the one in Anki, the popular flashcard app. New cards go through a few short learning steps, then the gap between reviews grows each time you remember the card.
Each card links to the section that teaches it, so when you miss one you can go straight back to the explanation. The decks cover one card per topic, the decisions inside each design question, and a walkthrough of each full design. Your review history is saved in your browser, and it's synced to your account if you sign in.
System design is usually one round of several. Most interview loops also include coding rounds on algorithms and data structures. For those, Interactive Coding Challenges is a free collection of problems with solutions in Python notebooks, and it includes its own Anki deck.
The handbook is still growing. The newest part covers AI systems: how large language models are served, what GPUs and inference engines do, retrieval, agents, evaluation and security. AI moves quickly, so these chapters date the facts that will age and link to the sources they come from. Worked design questions apply them to AI products, such as a chat assistant, a document question-answering service and an inference platform.
Some topics that were once listed here as unfinished now have full chapters:
If there's a topic you'd like to see, open an issue (see Contributing).
The handbook is open source, and fixes and improvements are welcome. The source is on GitHub at souvik-io/system-design-primer-webapp. You can help by:
Chapters are markdown files in the repository's content/ folder. Its README explains the chapter format, diagrams and flashcard decks. Open an issue first for anything large, so the work can be planned together.
The handbook began as a reader for The System Design Primer by Donne Martin, released under the Creative Commons Attribution 4.0 International License. Its syllabus shaped this one: the topics, their order, and the classic design questions all come from it. The chapters here are written fresh, and each one credits its own sources.
These resources were also thanked by the primer, and they remain worth reading:
For questions, corrections or ideas, open an issue on GitHub. It's the fastest way to reach the maintainer, and it lets others see the answer too.
The handbook's chapters and flashcards are licensed under the Creative Commons Attribution 4.0 International License (CC BY 4.0): you may share and adapt them as long as you credit the source. The site's code is released under the MIT License, in the repository's LICENSE file.
The System Design Primer, which the handbook's syllabus is based on, is © 2017 Donne Martin and licensed under CC BY 4.0.
Previous: Real-world architectures