{"id":"about","title":"About this handbook","sections":[{"id":"overview","title":"Overview","html":"<p>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.</p>\n<p>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 <a href=\"/learn/how-to-use-this-handbook\">How to use this handbook</a>.</p>","headings":[]},{"id":"flashcards","title":"Flashcards","html":"<h3 id=\"flashcards\">Flashcards</h3>\n<p>The <a href=\"/flashcards\">flashcards</a> help you remember what you've read. They use <strong>spaced repetition</strong>: 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.</p>\n<p>The scheduler works much like the one in <a href=\"https://apps.ankiweb.net/\" target=\"_blank\" rel=\"noopener noreferrer\">Anki</a>, 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.</p>\n<p>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.</p>\n<h4 id=\"coding-interview-practice\">Coding interview practice</h4>\n<p>System design is usually one round of several. Most interview loops also include coding rounds on algorithms and data structures. For those, <a href=\"https://github.com/donnemartin/interactive-coding-challenges\" target=\"_blank\" rel=\"noopener noreferrer\">Interactive Coding Challenges</a> is a free collection of problems with solutions in Python notebooks, and it includes its own Anki deck.</p>","headings":[{"id":"flashcards","title":"Flashcards","depth":3},{"id":"coding-interview-practice","title":"Coding interview practice","depth":4}]},{"id":"under-development","title":"Under development","html":"<h3 id=\"under-development\">Under development</h3>\n<p>The handbook is still growing. The newest part covers AI systems: <a href=\"/learn/llm-inference\">how large language models are served</a>, 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 <a href=\"/learn/design-chat-assistant\">chat assistant</a>, a <a href=\"/learn/design-rag-qa\">document question-answering service</a> and an <a href=\"/learn/design-inference-platform\">inference platform</a>.</p>\n<p>Some topics that were once listed here as unfinished now have full chapters:</p>\n<ul>\n<li><strong>MapReduce:</strong> <a href=\"/learn/batch-processing#mapreduce-the-foundational-model\">Batch processing</a>.</li>\n<li><strong>Consistent hashing:</strong> <a href=\"/learn/consistent-hashing\">Consistent hashing</a>.</li>\n<li><strong>Scatter-gather:</strong> <a href=\"/learn/database-internals#scatter-gather-queries\">scatter-gather queries</a> in Database internals, and the search service in <a href=\"/learn/design-twitter\">Design the Twitter timeline and search</a>.</li>\n</ul>\n<p>If there's a topic you'd like to see, open an issue (see <a href=\"/learn/about#contributing\">Contributing</a>).</p>","headings":[{"id":"under-development","title":"Under development","depth":3}]},{"id":"contributing","title":"Contributing","html":"<h3 id=\"contributing\">Contributing</h3>\n<p>The handbook is open source, and fixes and improvements are welcome. The source is on GitHub at <a href=\"https://github.com/souvik-io/system-design-primer-webapp\" target=\"_blank\" rel=\"noopener noreferrer\">souvik-io/system-design-primer-webapp</a>. You can help by:</p>\n<ul>\n<li>fixing errors, from typos to wrong numbers;</li>\n<li>making an explanation clearer;</li>\n<li>adding a chapter, a design question, a diagram or flashcards;</li>\n<li>translating the site.</li>\n</ul>\n<p>Chapters are markdown files in the repository's <code>content/</code> 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.</p>","headings":[{"id":"contributing","title":"Contributing","depth":3}]},{"id":"credits","title":"Credits","html":"<h3 id=\"credits\">Credits</h3>\n<p>The handbook began as a reader for <a href=\"https://github.com/donnemartin/system-design-primer\" target=\"_blank\" rel=\"noopener noreferrer\">The System Design Primer</a> by Donne Martin, released under the <a href=\"https://creativecommons.org/licenses/by/4.0/\" target=\"_blank\" rel=\"noopener noreferrer\">Creative Commons Attribution 4.0 International License</a>. 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.</p>\n<p>These resources were also thanked by the primer, and they remain worth reading:</p>\n<ul>\n<li><a href=\"https://www.hiredintech.com/system-design/\" target=\"_blank\" rel=\"noopener noreferrer\">HiredInTech's system design guide</a></li>\n<li><a href=\"https://www.amazon.com/dp/0984782850/\" target=\"_blank\" rel=\"noopener noreferrer\">Cracking the Coding Interview</a>, by Gayle Laakmann McDowell</li>\n<li><a href=\"https://highscalability.com/\" target=\"_blank\" rel=\"noopener noreferrer\">High Scalability</a></li>\n<li><a href=\"https://github.com/checkcheckzz/system-design-interview\" target=\"_blank\" rel=\"noopener noreferrer\">checkcheckzz/system-design-interview</a></li>\n<li><a href=\"https://github.com/shashank88/system_design\" target=\"_blank\" rel=\"noopener noreferrer\">shashank88/system_design</a></li>\n<li><a href=\"https://github.com/mmcgrana/services-engineering\" target=\"_blank\" rel=\"noopener noreferrer\">mmcgrana/services-engineering</a></li>\n<li><a href=\"https://gist.github.com/vasanthk/485d1c25737e8e72759f\" target=\"_blank\" rel=\"noopener noreferrer\">System design cheat sheet</a></li>\n<li><a href=\"https://dancres.github.io/Pages/\" target=\"_blank\" rel=\"noopener noreferrer\">A distributed systems reading list</a></li>\n<li><a href=\"https://tianpan.co/notes/2016-02-13-crack-the-system-design-interview\" target=\"_blank\" rel=\"noopener noreferrer\">Crack the system design interview</a></li>\n</ul>","headings":[{"id":"credits","title":"Credits","depth":3}]},{"id":"contact-info","title":"Contact info","html":"<h3 id=\"contact-info\">Contact info</h3>\n<p>For questions, corrections or ideas, <a href=\"https://github.com/souvik-io/system-design-primer-webapp/issues\" target=\"_blank\" rel=\"noopener noreferrer\">open an issue on GitHub</a>. It's the fastest way to reach the maintainer, and it lets others see the answer too.</p>","headings":[{"id":"contact-info","title":"Contact info","depth":3}]},{"id":"license","title":"License","html":"<h3 id=\"license\">License</h3>\n<p>The handbook's chapters and flashcards are licensed under the <a href=\"https://creativecommons.org/licenses/by/4.0/\" target=\"_blank\" rel=\"noopener noreferrer\">Creative Commons Attribution 4.0 International License</a> (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 <a href=\"https://github.com/souvik-io/system-design-primer-webapp/blob/main/LICENSE\" target=\"_blank\" rel=\"noopener noreferrer\">LICENSE</a> file.</p>\n<p>The System Design Primer, which the handbook's syllabus is based on, is © 2017 Donne Martin and licensed under <a href=\"https://creativecommons.org/licenses/by/4.0/\" target=\"_blank\" rel=\"noopener noreferrer\">CC BY 4.0</a>.</p>","headings":[{"id":"license","title":"License","depth":3}]}]}