Open-source project
getify/You-Dont-Know-JS avatar
getify/You-Dont-Know-JS

You Don't Know JS Yet: A Free, Opinionated Deep Dive into JavaScript's Core Mechanisms

GitHub describes it as A book series (2 published editions) on the JS language.. The metadata lists the NOASSERTION license. This article stays within the project description and details documented in the GitHub repository README.

184,856 stars33,331 forksUnknownNOASSERTION

At a glance

What is it?
Kyle Simpson's second-edition book series is a free online resource that explains JavaScript's internal behavior, aimed at developers who want more than surface-level syntax. It is complete and closed to contributions, which is both a strength and a constraint.
Who is it for?
Adopt this series if you are a JavaScript developer who wants a rigorous, mechanism-level understanding of scope, closures, objects, classes, types, and grammar, and you prefer reading over video. Do not adopt it if you need a beginner tutorial with exercises, or if you expect community updates, since the series is complete and closed to contributions.
Can I use it commercially?
Check first. The repository uses a licence we do not classify automatically, so read its LICENSE file before any commercial use.
Is it still maintained?
Yes. The repository last received commits 15 days ago.
What is it written in?
GitHub does not report a main language for this repository.

Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.

From daily snapshots

Star history

  • getify/You-Dont-Know-JS184,856 ★ · +201
Star history
Repository2026-08-132026-11-15
getify/You-Dont-Know-JS184.7k184.9k

201 Stars in the last 94 days, measured from the daily GitHub snapshot. Compare with other projects

Editorial analysis

What Problem This Book Series Solves

Most JavaScript tutorials teach syntax: how to write a function, how to use a promise, how to attach an event listener. This series targets the gap between that surface level and the actual behavior of the language engine. The README states the books dive deep into the core mechanisms of the JavaScript language. The intended reader is someone who already writes JavaScript but has unanswered questions about why code behaves the way it does. Kyle Simpson, the author, has spent over a decade on this project. The series does not teach you how to build an app. It teaches you how the language works under the hood. If you are a junior developer looking for step-by-step project guidance, this is not that book. If you are a mid-level or senior developer who has hit a bug caused by scope hoisting or type coercion, this series is aimed directly at you.

The Mechanism-First Architecture of the Second Edition

The second edition is not a single book but a structured series. The recommended reading order starts with Get Started, then Scope & Closures, then a collection called The Unbooks, which includes Objects & Classes and Types & Grammar. The ordering is deliberate: Get Started establishes the mental model, Scope & Closures builds on it with one of the most misunderstood areas of the language, and the Unbooks handle the remaining core mechanics. The README marks Objects & Classes as a stable draft and Types & Grammar as a rough draft, which tells you the series is not uniform in its polish. The author canceled two planned books, Sync & Async and ES.Next & Beyond, so the scope of the series is narrower than the first edition. This is a trade-off. The series covers less ground, but the material that remains is treated with more depth. The mechanism-first approach means each chapter explains how the engine resolves a variable, how the prototype chain works, or how coercion behaves, rather than just showing syntax examples. This is a book for reading slowly, not for skimming.

How to Get It Running: Commands and Setup

There is no installation step. The books are available entirely for free online in the repository. You can read them directly on GitHub by navigating to the folder for each book, for example get-started/README.md or scope-closures/README.md. If you want a local copy, you can clone the repository with git clone https://github.com/getify/You-Dont-Know-JS.git, then switch to the default branch, which is 2nd-ed. The README does not mention any build tools or dependencies, because there are none. This is a plain-text book series, not a software project. For a physical or ebook copy, the README links to Leanpub and Amazon for each title. The first two books of the second edition are sponsored by Frontend Masters, but that sponsorship does not restrict access; the online text is free. The absence of a package manager or configuration file is refreshing. You open the files and read. The only requirement is a web browser or a text editor.

Where the Series Falls Short: Incomplete Drafts and Closed Contributions

The most obvious limitation is that the series is not fully finished. The README labels Types & Grammar as a rough draft, and the Unbooks as a whole are described as an ebook, not as polished printed books. If you are looking for a consistent, final-edited reference, the rough draft sections will disappoint you. A second limitation is that the series is closed to contributions. The README states explicitly that the book series is now complete and is not open to further contributions. This means errors, if any, will not be corrected by the community. You are relying on the author alone. The cancellation of the Sync & Async and ES.Next & Beyond titles is another gap. If you wanted the second edition to cover promises, async/await, or modern syntax beyond types and grammar, you will not find them here. The first edition covers some of that, but the second edition deliberately omits it. Finally, the license is restrictive: Creative Commons Attribution-NonCommercial-NoDerivs 4.0. You can read and share it, but you cannot sell it, and you cannot create derivative works. For a technical book that people often want to quote or adapt, that is a real constraint.

The First Edition as a Necessary Alternative

The repository still hosts the first edition on a separate branch, 1st-ed. This is the real alternative to the second edition. The first edition is a different series: it covers topics like this and object prototypes, async and performance, and ES6 and beyond, which the second edition has cut. If your interest is in asynchronous JavaScript or newer syntax, the first edition is the only option in this repository. The second edition is more focused but narrower. The first edition is also free online, so the cost of trying both is zero. If you have never read either, you should decide based on which topics matter to you, not on which edition is newer.

Maintenance and Upgrade Cost: A Static Resource, Not a Live Project

Because the series is closed to contributions and the author has declared it complete, there is no maintenance cost in the usual sense. You will not receive updates, and you should not expect the repository to change. The last push was on 2026-10-31, even though the series is declared complete. The upgrade cost is the cost of moving from the first edition to the second edition. The second edition is not a drop-in replacement. The reading order is different, the topics are different, and some titles are canceled. If you have invested time in the first edition, you will need to unlearn some framing, not just add new chapters. The license is a bigger cost. The NonCommercial and NoDerivs clauses mean you cannot legally create a translated version, a summary, or a course based on this text without permission. If you are a trainer or a content creator, that is a significant barrier. The README says the project is not open to further contributions, and it names no channel for reporting mistakes in the rough draft of Types & Grammar.

Who Should Read It and What to Verify First

The ideal reader is a developer who has been writing JavaScript for at least a year and has felt the limits of tutorial-driven learning. The series rewards slow, deliberate reading. It is not a reference manual, and it is not a quick fix for a specific bug. It is a foundation. The rough draft status of Types & Grammar means you should check the date of the last commit on that folder before relying on it for current language behavior, since the repository's last push was on 2026-10-31. You should also verify that the edition you are reading matches your target environment, because the materials are copyrighted 2019-2025. For a beginner, the series will be frustrating because it assumes you already know how to write JavaScript. For an expert, the series will be a useful check on assumptions. The author's teaching style is direct and opinionated, so you will not get a neutral survey of the language. You will get one person's carefully argued view of how JavaScript works. That is exactly what the series promises, and it delivers on that promise within the limits of its unfinished sections.

Editorial conclusion

Adopt this series if you are a JavaScript developer who wants a rigorous, mechanism-level understanding of scope, closures, objects, classes, types, and grammar, and you prefer reading over video. Do not adopt it if you need a beginner tutorial with exercises, or if you expect community updates, since the series is complete and closed to contributions. Before relying on it, verify that the edition you read matches your target runtime, because the materials are copyrighted 2019-2025, and the first edition is still available separately. The series is free online, but the license restricts commercial use and derivative works, so check your intended use case first.

Frequently asked questions

Is You Don't Know JS still being written?

No. The series is stated to be complete and not open to further contributions, after an 11 year journey. The repository has no GitHub releases, and the last push was 2026-10-31, with the materials copyrighted 2019-2025.

What license is You Don't Know JS under?

The materials are copyright 2019-2025 Kyle Simpson and licensed under Creative Commons Attribution-NonCommercial-NoDerivs 4.0 Unported, stored as LICENSE.txt. Repository metadata reports the license as unasserted, so the terms have to be read from the file. NoDerivs rules out translations and adapted editions, and NonCommercial rules out paid use.

Do I need to buy the You Don't Know JS books?

No, the books are readable online in the repository entirely for free. The second edition is self-published through GetiPub and sold on Leanpub and Amazon.

Official sources

  1. Official documentation
  2. Official README
  3. Project repository
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/getify-you-dont-know-js.svg)](https://hysenlabs.com/projects/getify-you-dont-know-js)

Star history chart for your README

markdown
[![Star history](https://hysenlabs.com/chart/getify-you-dont-know-js.svg)](https://hysenlabs.com/projects/getify-you-dont-know-js)

Was this useful?