Link Search Menu Expand Document

LEGO (Lightweight Embedded Gluten-free Objects) is a library for writing fast ♻️ reactive, 📦 scoped and predictable 🏡 native web-components in HTML/CSS/JS, that are easy to digest 🌱 for your browser.

Example (my-example.html):

  <p>Hey Joe</p>
  p { color: chocolate }

These are native HTML elements with Shadow DOM, slots and all native features from the official specs.

Lego is:

  • 👙 Minimalist: ~74~ 61 lines of readable code in its core (non-optimised, uncompressed, no cheating).
  • 🌱 Low dependency: its single third-party is the minimalist Petit-Dom which itself has no dependency
  • ♻️ Reactive: updating the state recalculate the Virtual Dom when needed
  • 🚀 fast: using virtual dom through a thin layer makes it close to bare-metal
  • 💧 Simple: that’s Vanilla, there isn’t much to know, it’s a raw class to extend; no magic ✨
  • 🏡 Native: webcomponents are actual native webcomponents, you benefit from all the today’s and tomorrow’s possibilites (slot, encapsulation, …)
  • 🦺 Safe: because it has no third-party dependency and is fully based on browser features, it’s secured and upgraded via your browser.

Lego is not (and will never be):

  • 🏯 A full bloated frontend framework with built-in routing. Others do it well.
  • 🏗 A website builder with buit-in SSR or similar complexities.
  • 🔐 An HTML replacement that locks you into a specific technology.
  • 🧓 An old browsers or IE compatible library (you may try webcomponent polyfills if you feel wild).

View the demo and their source 🧪.

Lego is inspired from the native Web-Component spec and Riot.

It’s just much lighter with simplicity, a source code that is readable for a regular human which makes it accessible to hack, tweak and maintain in the loooong term. The core lib is only 61 LOC! Lego is as light as 3Kb for the full bundle!

No Babel transpiler, no Parcel, no Webpack… it just works out of the box.

Demo: view in action