feat(core): add internal flag to skip bundling (#11156)

slorber · web-flow · commit e905b93c90bd · 2025-05-06T16:30:35.000+02:00
diff --git a/packages/docusaurus/src/commands/build/buildLocale.ts b/packages/docusaurus/src/commands/build/buildLocale.ts
@@ -34,6 +34,8 @@ export type BuildLocaleParams = {
   cliOptions: Partial<BuildCLIOptions>;
 };
 
+const SkipBundling = process.env.DOCUSAURUS_SKIP_BUNDLING === 'true';
+
 export async function buildLocale({
   siteDir,
   locale,
@@ -82,19 +84,25 @@ export async function buildLocale({
           // We also clear website/build dir
           // returns void, no useful result needed before compilation
           // See also https://github.com/facebook/docusaurus/pull/11037
-          clearPath(outDir),
+          SkipBundling ? undefined : clearPath(outDir),
         ]),
     );
 
-  // Run webpack to build JS bundle (client) and static html files (server).
-  await PerfLogger.async(`Bundling with ${props.currentBundler.name}`, () => {
-    return compile({
-      configs:
-        // For hash router we don't do SSG and can skip the server bundle
-        router === 'hash' ? [clientConfig] : [clientConfig, serverConfig],
-      currentBundler: configureWebpackUtils.currentBundler,
+  if (SkipBundling) {
+    console.warn(
+      `Skipping the Docusaurus bundling step because DOCUSAURUS_SKIP_BUNDLING='true'`,
+    );
+  } else {
+    // Run webpack to build JS bundle (client) and static html files (server).
+    await PerfLogger.async(`Bundling with ${props.currentBundler.name}`, () => {
+      return compile({
+        configs:
+          // For hash router we don't do SSG and can skip the server bundle
+          router === 'hash' ? [clientConfig] : [clientConfig, serverConfig],
+        currentBundler: configureWebpackUtils.currentBundler,
+      });
     });
-  });
+  }
 
   const {collectedData} = await PerfLogger.async('SSG', () =>
     executeSSG({
@@ -231,7 +239,7 @@ async function getBuildServerConfig({
 async function cleanupServerBundle(serverBundlePath: string) {
   if (process.env.DOCUSAURUS_KEEP_SERVER_BUNDLE === 'true') {
     logger.warn(
-      "Will NOT delete server bundle because DOCUSAURUS_KEEP_SERVER_BUNDLE is set to 'true'",
+      "Will NOT delete server bundle because DOCUSAURUS_KEEP_SERVER_BUNDLE='true'",
     );
   } else {
     await PerfLogger.async('Deleting server bundle', async () => {
diff --git a/website/docusaurus.config.ts b/website/docusaurus.config.ts
@@ -324,7 +324,7 @@ export default async function createConfigAsync() {
           showLastUpdateTime: true,
         } satisfies DocsOptions,
       ],
-      [
+      !process.env.DOCUSAURUS_SKIP_BUNDLING && [
         'client-redirects',
         {
           fromExtensions: ['html'],

Original file line number	Diff line number	Diff line change
`@@ -324,7 +324,7 @@ export default async function createConfigAsync() {`
`324`	`324`	`showLastUpdateTime: true,`
`325`	`325`	`} satisfies DocsOptions,`
`326`	`326`	`],`
`327`		`- [`
	`327`	`+ !process.env.DOCUSAURUS_SKIP_BUNDLING && [`
`328`	`328`	`'client-redirects',`
`329`	`329`	`{`
`330`	`330`	`fromExtensions: ['html'],`