Feature tour

See every feature of the plugin running, each next to the guide that sets it up. Everything on this page is live: the figures are the plugin’s own UI, not screenshots.

Hot patching that keeps state

Save a component and the page stays put. A hot patch is an edit applied to the running page without a reload: the plugin updates the class in place, so every element keeps its state. The indicator in the corner of the page pulses green when a patch lands. Click the figure to replay the pulse.

On by default. Guide: Keep state across edits.

One stylesheet for every shadow root

Import a CSS file with ?css-sheet and every component that imports it adopts the same CSSStyleSheet. Save the file and the plugin swaps that sheet’s text: every shadow root restyles in place, nothing re-renders, and the page keeps its state. Without it, saving the CSS reloads the page.

Select some tiles in both panes, then save an edit. The plugin pane runs replaceSync() on the shared sheet, as the dev server does on save; the counts and the restyle time are measured on the page.

On by default. Guide: Share one stylesheet with ?css-sheet.

Open a component’s source from the page

Hold the shortcut and point at any element. The overlay outlines the component and names the file and line that declares it and the one that renders it. Click to open either in your editor.

Counter: HELLOCount: 0 renders: 1

Turn on: sourceOverlay option. Guide: Open a component in your editor from the page.

Inspect live components

The DevTools panel lists every Lit element on the page as a tree. Select one to read and edit its properties, state and controllers while it runs. This is the whole panel, inspecting a small cart above it.

Expand demo-cart, select a cart-item, then change its qty or price. The total follows, and the item's docs show above its properties.

Turn on: the timeline option, with Vite DevTools. Guide: Set up the DevTools panel, then Inspect live components.

Read every component’s documentation

Select an element and the details pane shows what its author wrote: a summary, what each property is for, the events it fires, its slots, parts and CSS custom properties. The cart above is documented by a Custom Elements Manifest it links. Your own components need none: their JSDoc is read from source as you edit.

Your componentssrc/user-card.ts

/**
 * A user's avatar and name.
 * @fires select - The card was chosen.
 * @slot - Extra details under the name.
 * @csspart avatar - The image.
 */

Read from source while you edit. No manifest needed.

Librariesnode_modules/…/package.json
```
"customElements": "custom-elements.json"
```
Found through each dependency. Web Awesome comes documented.

Any siteindex.html

<link rel="custom-elements-manifest"
      href="/custom-elements.json">

Lit Inspector reads the manifests a page links.

Components tab
Lit Inspector
Your coding agent

The same docs reach Lit Inspector and, through the lit_component-docs MCP tool, your coding agent.

Guide: Read a component’s documentation.

See every update and its cause

The Updates tab counts each component’s updates and shows what changed in each, with the time it took.

A recorded session in the Updates tab: one row per component, with its update count and timings.

Guide: Updates.

Read a session on one timeline

Record a session and the Timeline puts every render, property change, patch and custom event on one time axis, in tracks or as a list.

A recorded session in Tracks mode: one lane per layer, events in time. Drag across the ruler to zoom.

Guide: Record and read the timeline.

Give your coding agent the page

The same component tree and timeline are MCP tools. An agent asks which components re-rendered and why, and reads the answer from the running page instead of guessing from the code.

Guide: Connect a coding agent.

Inspect sites you don’t serve

Lit Inspector is the same panel as a browser extension. It works on production builds and on any Lit site, with no Vite and no plugin.

Get it on theChrome Web Store Get it on theFirefox Add-ons

In Chrome it also adds a Lit tab to the Elements panel, beside Styles and Computed. Select any node there and the tab shows the Lit element at or around it. Below, the Elements tree is drawn from the cart’s real DOM and the Lit tab is the real panel, following it.

Select a node in the tree, or hover one to find it on the page.

Guide: Inspect any site with Lit Inspector, and its section on the browser’s own panels.

InstallationInstall the plugin and add it to your Vite config.

Compared to alternativesPlain Vite, Open Web Components' HMR plugin, and a Vite fork of it.