Skip to content

Architectural Deep Dive

Welcome to the internal documentation of LegoDOM.

This isn't a "how to use" guide. This is a "how it works" guide. I believe that understanding the soul of LegoDOM should/could make you a better contributor.

The Philosophy

"The Platform is the Runtime." We avoid compilers, transpilers, and VDOMs. We use:

  • Proxies for state.
  • TreeWalkers for scanning.
  • Regex for parsing.
  • MutationObservers for efficiency.

The Journey

Follow the path of a block from HTML string to Pixel:

  1. Init - How LegoDOM wakes up.
  2. Scanner - How we find holes in your HTML (Regex vs AST).
  3. Studs - The Reactivity Engine (Proxies).
  4. Render - The "Loop of Truth" & Security.
  5. Router - The "Surgical" Update philosophy.

Dive in.

Released under the MIT License.