Code splitting

Arguably the biggest difference you can make speeding up your user experience is by using dynamic imports in your code. This splits out the Web Component loader into a lazy-loading chunk that doesnโ€™t block your main bundle.

// Before
import { defineCustomElements } from '@manifoldco/ui/dist/loader';

// After
import(/* webpackChunkName: manifold-ui */ '@manifoldco/ui/dist/loader').then(
  ({ defineCustomElements }) => defineCustomElements(window)

๐Ÿ’ Tip: webpackChunkName is useful in webpack setups to ensure if you use this code more than once, itโ€™ll re-use the same chunk each time rather than create multiple copies.

Though code splitting may technically delay the Web Componentsโ€™ loading (because itโ€™s fetching an async request to get the loader, rather than being bundled already by the time this is executed), overall code splitting is generally a win for users, and lets you deliver a first meaningful paint sooner.

Lazy-loading everything indiscriminately across your application would slow down the user experience, but when used strategically like this it can have big payoffs.

Caching OAuth tokens

Another opportunity to greatly speed up the user experience on page load is to cache the tokens from <manifold-auth-token>. For more information, see the Caching section in the authentication guide

Other Gotchas

Though thereโ€™s nothing actionable in this section, itโ€™s nice to have a general understanding of how Stencil is bundled as it affects your application.

Efficient element loading

Stencil splits up custom elements into their own chunks. For our UI bundle, if you only use <manifold-product> and <manifold-plan-selector> on a page, your users will download the JS to render those two, and only those two. Over time, even as Manifold UI adds more components, it comes at almost no performance cost to your users.

To see this in action, open your Network tab in Chrome, and filter to JS. You should see things like 15.js and 53.js, each weighing only a few KB.

Polyfill bloat

Stencilโ€™s Web Components work for browsers without Web Component support via a polyfill. Itโ€™s great to have built-in support, but sometimes webpack can accidentally bundle the polyfill when it doesnโ€™t need to. Weโ€™ve found the best fix to be code splitting.


RTT of endpoint calls are calculated and emitted as events - either from document or from an EventEmitter supplied by the component calling the endpoint.

A solution to listen for and log these events is currently left as an implementation detail on the platform side:

document.addEventListener('manifold-rest-fetch-duration', { detail } => {
  console.log(detail); // { endpoint: "/catalog/products", duration: 95 }