feat(v2): add ability to create unminimized bundles (#2474)

packages/docusaurus-types/src/index.d.ts

@@ -64,6 +64,7 @@ export interface StartCLIOptions {
 export interface BuildCLIOptions {
   bundleAnalyzer: boolean;
   outDir: string;
+  minify: boolean;
 }
 
 export interface LoadContext {

packages/docusaurus/bin/docusaurus.js

@@ -45,10 +45,15 @@ cli
     '--out-dir <dir>',
     'The full path for the new output directory, relative to the current workspace (default = build).',
   )
-  .action((siteDir = '.', {bundleAnalyzer, outDir}) => {
+  .option(
+    '--no-minify',
+    'Build website without minimizing JS bundles (default = false)',
+  )
+  .action((siteDir = '.', {bundleAnalyzer, outDir, minify}) => {
     wrapCommand(build)(path.resolve(siteDir), {
       bundleAnalyzer,
       outDir,
+      minify,
     });
   });
 

packages/docusaurus/src/commands/build.ts

@@ -61,7 +61,9 @@ export async function build(
     generatedFilesDir,
     'client-manifest.json',
   );
-  let clientConfig: Configuration = merge(createClientConfig(props), {
+  let clientConfig: Configuration = merge(
+    createClientConfig(props, cliOptions.minify),
+    {
       plugins: [
         // Remove/clean build folders before building bundles.
         new CleanWebpackPlugin({verbose: false}),
@@ -72,7 +74,8 @@ export async function build(
           filename: clientManifestPath,
         }),
       ].filter(Boolean) as Plugin[],
-  });
+    },
+  );
 
   let serverConfig: Configuration = createServerConfig(props);
 

packages/docusaurus/src/webpack/base.ts

@@ -34,11 +34,13 @@ export function excludeJS(modulePath: string) {
 export function createBaseConfig(
   props: Props,
   isServer: boolean,
+  minify: boolean,
 ): Configuration {
   const {outDir, siteDir, baseUrl, generatedFilesDir, routesPaths} = props;
 
   const totalPages = routesPaths.length;
   const isProd = process.env.NODE_ENV === 'production';
+
   return {
     mode: isProd ? 'production' : 'development',
     output: {
@@ -78,8 +80,9 @@ export function createBaseConfig(
     optimization: {
       removeAvailableModules: false,
       // Only minimize client bundle in production because server bundle is only used for static site generation
-      minimize: isProd && !isServer,
+      minimize: minify && isProd && !isServer,
-      minimizer: isProd
+      minimizer:
+        minify && isProd
           ? [
               new TerserPlugin({
                 cache: true,

packages/docusaurus/src/webpack/client.ts

@@ -15,10 +15,13 @@ import {createBaseConfig} from './base';
 import ChunkAssetPlugin from './plugins/ChunkAssetPlugin';
 import LogPlugin from './plugins/LogPlugin';
 
-export function createClientConfig(props: Props): Configuration {
+export function createClientConfig(
+  props: Props,
+  minify: boolean = true,
+): Configuration {
   const isProd = process.env.NODE_ENV === 'production';
   const isBuilding = process.argv[2] === 'build';
-  const config = createBaseConfig(props, false);
+  const config = createBaseConfig(props, false, minify);
 
   const clientConfig = merge(config, {
     entry: [

packages/docusaurus/src/webpack/server.ts

@@ -15,7 +15,10 @@ import {createBaseConfig} from './base';
 import WaitPlugin from './plugins/WaitPlugin';
 import LogPlugin from './plugins/LogPlugin';
 
-export function createServerConfig(props: Props): Configuration {
+export function createServerConfig(
+  props: Props,
+  minify: boolean = true,
+): Configuration {
   const {
     baseUrl,
     routesPaths,
@@ -24,7 +27,7 @@ export function createServerConfig(props: Props): Configuration {
     preBodyTags,
     postBodyTags,
   } = props;
-  const config = createBaseConfig(props, true);
+  const config = createBaseConfig(props, true, minify);
 
   const routesLocation = {};
   // Array of paths to be rendered. Relative to output directory

website/docs/cli.md

@@ -65,6 +65,7 @@ Compiles your site for production.
 | --- | --- | --- |
 | `--bundle-analyzer` |  | Analyze your bundle with [bundle analyzer](https://github.com/webpack-contrib/webpack-bundle-analyzer) |
 | `--out-dir` | `build` | The full path for the new output directory, relative to the current workspace. |
+| `--no-minify` | `false` | Build website without minimizing JS/CSS bundles. |
 
 ### `docusaurus swizzle`