[docs] Track the bundle size

.circleci/config.yml

@@ -68,19 +68,22 @@ jobs:
       - run:
           name: Can we generate the build?
           command: yarn build
+      - run:
+          name: Can we build the docs?
+          command: yarn docs:build
       - run:
           name: Is the size acceptable?
           command: yarn size
+  test_browser:
+    <<: *defaults
+    steps:
+      - *restore_repo
       - run:
           name: Can we generate the api of the docs?
           command: yarn docs:api
       - run:
           name: Should not have any git not staged
           command: git diff --exit-code
-  test_browser:
-    <<: *defaults
-    steps:
-      - *restore_repo
       - run:
           name: Tests real browsers
           command: yarn test:karma

.size-limit

@@ -1,10 +1,17 @@
 [
   {
+    "description": "The initial cost people pay for using one component",
+    "path": "test/size/overhead.js",
+    "limit": "25.6 KB"
+  },
+  {
+    "description": "The size of the whole library.",
     "path": "build/index.js",
     "limit": "95.6 KB"
   },
   {
-    "path": "test/size/overhead.js",
-    "limit": "25.6 KB"
+    "description": "The main bundle of the documentation",
+    "path": ".next/app.js",
+    "limit": "156 KB"
   }
 ]

next.config.js

@@ -3,7 +3,6 @@ const pkg = require('./package.json');
 const { BundleAnalyzerPlugin } = require('webpack-bundle-analyzer');
 const { findPages } = require('./docs/src/modules/utils/find');
 
-const ENABLE_STATS = false;
 process.env.MATERIAL_UI_VERSION = pkg.version;
 
 module.exports = {
@@ -16,7 +15,7 @@ module.exports = {
       }),
     ]);
 
-    if (ENABLE_STATS) {
+    if (process.env.DOCS_STATS_ENABLED) {
       plugins.push(
         // For all options see https://github.com/th0r/webpack-bundle-analyzer#as-plugin
         new BundleAnalyzerPlugin({

package.json

@@ -29,6 +29,7 @@
     "docs:start": "next start",
     "docs:export": "next export -o docs/export",
     "docs:deploy": "yarn docs:build && yarn docs:export && firebase deploy",
+    "docs:size-why": "DOCS_STATS_ENABLED=true yarn docs:build",
     "prebuild": "rimraf build",
     "build:es2015": "cross-env NODE_ENV=production babel ./src --ignore *.spec.js --out-dir ./build",
     "build:es2015modules": "cross-env NODE_ENV=production BABEL_ENV=modules babel ./src/index.js --out-file ./build/index.es.js",