Lit is a simple library for building fast, lightweight web components.
At Lit's core is a boilerplate-killing component base class that provides reactive state, scoped styles, and a declarative template system that's tiny, fast and expressive.
See the full documentation for Lit at lit.dev.
For information about upgrading lit-html 1.x and lit-element 2.x code, see the Lit 2.0 Upgrade Guide.
To install from npm:
npm i lit
This is the monorepo for upcoming Lit packages, including
lit-html 2.0 and
lit-html 1.x source is available on the
- Core packages
lit- The primary user-facing package of Lit which includes everything from lit-html and lit-element.
lit-element- The web component base class used in Lit.
lit-html- The rendering library used by LitElement.
@lit/reactive-element- A low level base class that provides a reactive lifecycle based on attribute/property changes.
- Additional libraries
@lit-labs/ssr- A server package for rendering Lit templates and components on the server.
@lit-labs/ssr-client- A set of client-side support modules for rendering Lit components and templates on the server using
@lit-labs/eleventy-plugin-lit- A plugin for Eleventy that pre-renders Lit components using
@lit-labs/ssrwith optional hydration.
@lit-labs/react- A React component wrapper for web components.
@lit-labs/router- A router for Lit.
@lit-labs/task- A controller for Lit that renders asynchronous tasks.
@lit-labs/motion- Lit directives for making things move
@lit-labs/scoped-registry-mixin- A mixin for LitElement that integrates with the speculative Scoped CustomElementRegistry polyfill.
- Starter kits (not published to npm)
- Internal packages (not published to npm)
Contributing to Lit
Lit is open source and we appreciate issue reports and pull requests. See CONTRIBUTING.md for more information.
Setting up the lit monorepo for development
git clone https://github.com/lit/lit.git cd lit npm ci
Build all packages:
npm run build
Test all packages:
npm run test
Run benchmarks for all packages:
npm run benchmarks
See individual package READMEs for details on developing for a specific package.