// the find
jamiebuilds/babel-handbook
:blue_book: A guided handbook on how to use Babel and how to create plugins for Babel.
Two-part written guide covering Babel from basic configuration through writing custom plugins and traversing ASTs. Written by Jamie Kyle, one of Babel's original maintainers, so the plugin handbook in particular reflects how the internals actually work rather than guesswork. Primarily useful to anyone writing a Babel plugin or trying to understand visitor patterns and path manipulation.
The plugin handbook is the definitive reference for understanding Babel's visitor API, path objects, and scope handling — information that's scattered and hard to piece together from source code alone. It was written by someone who built the thing, so the mental models are accurate. Translation into 25+ languages means it reached a genuinely broad audience. The two-document split (user handbook vs plugin handbook) keeps beginner setup concerns separate from the internals deep-dive.
Last meaningful update was years ago and the content shows it — Babel 7 brought a significant package rename (@babel/* scoping), monorepo restructure, and config changes that parts of the user handbook don't reflect. The plugin handbook covers the AST visitor model well but says nothing about modern patterns like macro-style plugins or Babel's role in a Vite/SWC world where it's increasingly optional. There are no runnable examples or a companion repo — you're expected to set everything up yourself. Translations are community-maintained and several are badly out of date with the English source.