Cover image for How to implement loadable components for bundle splitting with SSR support.

How to implement loadable components for bundle splitting with SSR support.

shandilyaprasanna profile image Prasanna Shandilya Updated on ・4 min read

Before Jumping into code spitting using loadable lets understand some concepts:-

Client-side rendering vs Server-side rendering

In Client-Side Rendering, browser downloads a minimal HTML page, then it renders the JavaScript and fills the content into it.

In Server-side rendering, on the other hand, browser renders components on the server. output is HTML which is already filled with content, so there is no need to fetch any JS.
After that, we need a mechanism to hydrate it on the client-side with your JS and make it functional.

Choosing the right library

1. React.lazy and Suspense

React.lazy provides syntax on top of your bundler’s code splitting (webpack or parcel) and call import when it’s getting rendered within the component.

The lazy component should then be rendered inside a Suspense component, which allows us to show some fallback content

  • React.lazy supports SSR
  • but Suspense does NOT.

Suspense is not available server-side and React.lazy can only work with Suspense. That's why today, React.lazy is not an option if you need Server Side Rendering.

2. React loadable

-> popular library but not that well maintained.
-> Issues are closed so there is no community around,
-> Last publish was 2 year back
-> it is not compatible with Webpack v4+ and Babel v7+.

so you should not be using react loadable now, If you are using you should migrate to react Lazy or loadable component.

3. Loadable components

@loadable/component provides a complete solution to make Server Side Rendering possible and takes care of synchronously loading components

import loadable from “@loadable/components“;
const MyComponent = loadable(() => import(“../my/component/path.js”), 
{ssr: true});
<MyComponent /> // Just render your Component 

here will have its separate javascript bundle and its done using module bundler
there is option to pass object with SSR as key to choose wether you can your component to SSRed or not

If its true, then component gets rendered on the server and then we can hydrate the functionality on the client-side by executing the injected JavaScript from loadable-stats.json

Alt Text

Flowchart to show how loadable works at high level

Alt Text

Now lets get into Steps

1. Install @loadable/babel-plugin


  "plugins": ["@loadable/babel-plugin"]

If you don’t want to follow this step, you can add this in the webpack config file where you have plugins for babel defined.

2. Install @loadable/webpack-plugin

3. Create a webpack loadable plugin.


const LoadablePlugin = require('@loadable/webpack-plugin')
module.exports = {
  // ...
  plugins: [new LoadablePlugin()],

new LoadablePlugin({ filename: 'stats.json', writeToDisk: true })

It generates a file called loadable-stats.json, which contains information about all your entries and chuncks from webpack.


It maintains mapping of all the components by chunk name.

It informs loadable about the component dependencies. It also tells about all the CSS and JS bundles required for that component.

4. Setup ChunkExtractor server-side

ChunkExtractor is a constructor function, that takes loadable-stats.json file as argument and return instance of function of your stats file.

It takes your main app component to this instance and fetch the chunks required for this component.

The chunks we extract using “extractor.collectChunks” is the JSX that will be passed to the renderToString function.

Collecting chunks

The basic API goes as follows:

import { renderToString } from 'react-dom/server'
import { ChunkExtractor } from '@loadable/server'
const statsFile = path.resolve('../dist/loadable-stats.json')
const extractor = new ChunkExtractor({ statsFile })
const html = renderToString(extractor.collectChunks(<YourApp />))
const scriptTags = extractor.getScriptTags() // or extractor.getScriptElements();

The collectChunks method wraps your element in a provider. Optionally you can use the ChunkExtractorManager provider directly, instead of this method. Just make sure not to use it on the client-side.

getScriptTags- returns a string of script tags which are “async”.

getStyleTags- returns a string of link elements with the “data-chunk” attribute set to the component’s chunk name.

import { renderToString } from 'react-dom/server'
import { ChunkExtractor, ChunkExtractorManager } from '@loadable/server'
const statsFile = path.resolve('../dist/loadable-stats.json')
const extractor = new ChunkExtractor({ statsFile })
const html = renderToString(
  <ChunkExtractorManager extractor={extractor}>
    <YourApp />
const scriptTags = extractor.getScriptTags() // or extractor.getScriptElements();

The extractor.getScriptTags() returns a string of multiple <script> tags marked as "async". You have to wait for them to be ready using loadableReady.

Alternatively the ChunkExtractor also has a getScriptElements() method that returns an array of React elements.

5. Add loadableReady client-side

Loadable components loads all your scripts asynchronously to ensure optimal performances. All scripts are loaded in parallel, so you have to wait for them to be ready using loadableReady.

import { loadableReady } from '@loadable/component'
loadableReady(() => {
  const root = document.getElementById('main')
  hydrate(<App />, root)

6. Fallback without Suspense

If in case you have loadable({ssr:false}). You would like to have some loading state.

You can specify a fallback in loadable options.

const OtherComponent = loadable(() => import('./OtherComponent'), {
  fallback: <div>Loading...</div>,
function MyComponent() {
  return (
      <OtherComponent />

You can also specify a fallback in props:

const OtherComponent = loadable(() => import('./OtherComponent'))
function MyComponent() {
  return (
      <OtherComponent fallback={<div>Loading...</div>} />


-> If you only need to do code splitting client side you can use React.lazy and don’t have to take pain for setting up any other library.

-> You can also go with react-loadable-visibility/loadable-components for achieving ssr as it is build on top of React.lazy and provides support for Intersection Observer.

!!Thank You!!

Posted on Feb 22 by:

shandilyaprasanna profile

Prasanna Shandilya


I am a JS developer with industry experience in OTT and E-commerce domain building websites, web applications and PWA. I specialize in JavaScript with experience in react, node.


markdown guide