Building for production
This page focuses on recommendations for building an application that uses Lit components for production. For recommendations on build steps to perform on source code prior to publishing a reusable Lit component to npm, see Publishing.
See Requirements for a full list of requirements for building Lit code, which apply to both development and production.
In addition to those minimum requirements, this page describes optimizations you should consider when preparing code for production, as well as a concrete Rollup configuration that implements them.
Preparing code for productionPermalink to “Preparing code for production”
Lit projects benefit from the same build-time optimizations as other web projects. The following optimizations are recommended when serving Lit applications in production:
- Serving modern code to modern browsers as it is generally smaller and faster, and falling back to compiled code on older browsers.
- Enabling serve-time compression (such as gzip or brotli) for fewer bytes over the wire.
Building with RollupPermalink to “Building with Rollup”
There are many tools you can use to perform the required and optional build steps necessary to serve Lit code, and Lit does not require any one specific tool. However, we recommend Rollup because it's designed to work with the standard ES module format and output optimal code that leverages native modules on the client.
There are many ways to set up Rollup to bundle your project. The Modern Web project maintains an excellent Rollup plugin
@web/rollup-plugin-html that helps tie a number of best-practices for building applications together into an easy-to-use package. Example configurations using this plugin are described below.
Modern-only buildPermalink to “Modern-only build”
rollup.config.js file below will build an application that meets the modern browser build requirements and production optimizations described on this page. This configuration is suitable for serving to modern browsers that can run ES2021 JS without polyfills.
Required node modules:
Running the rollup build: