Fix: Completely disable CSS minification to prevent breaking Tailwind CSS v4

Author: saiyam1814

plugins/fix-css-minification.js

@@ -1,6 +1,6 @@
 /**
  * Docusaurus plugin to fix CSS minification issues with Tailwind CSS v4
- * This prevents the CSS minifier from breaking Tailwind's output
+ * Completely disables CSS minification to prevent breaking Tailwind's output
  */
 function fixCssMinification(context, options) {
   return {
@@ -10,54 +10,18 @@ function fixCssMinification(context, options) {
         return {};
       }
 
-      // Find and configure CSS minimizer
-      const minimizerPlugins = config.optimization?.minimizer || [];
-      
-      minimizerPlugins.forEach((plugin, index) => {
-        // Check if this is the CSS minimizer plugin
-        // It could be CssMinimizerPlugin or an instance
-        const pluginName = plugin?.constructor?.name || '';
-        const isCssMinimizer = pluginName === 'CssMinimizerPlugin' || 
-                              pluginName.includes('CssMinimizer') ||
-                              (plugin.constructor && plugin.constructor.toString().includes('CssMinimizer'));
-        
-        if (isCssMinimizer) {
-          // Replace with a safer configuration
-          try {
-            // Try to configure the minimizer to be less aggressive
-            if (plugin.options) {
-              plugin.options.minimizerOptions = {
-                preset: [
-                  'default',
-                  {
-                    // Critical: Disable features that break Tailwind CSS v4
-                    discardComments: { removeAll: false },
-                    normalizeWhitespace: false,
-                    reduceIdents: false, // Don't rename keyframes
-                    mergeRules: false, // Don't merge rules
-                    reduceTransforms: false,
-                    discardUnused: false,
-                    // Only safe minifications
-                    minifySelectors: true,
-                    minifyParams: true,
-                    minifyFontValues: true,
-                    minifyGradients: true,
-                    minifyTimingFunctions: true,
-                  },
-                ],
-              };
-            }
-            
-            // Also try to set parallel to false to avoid race conditions
-            if (plugin.options && typeof plugin.options.parallel !== 'undefined') {
-              plugin.options.parallel = false;
-            }
-          } catch (e) {
-            // If configuration fails, try to replace the plugin entirely
-            console.warn('Could not configure CSS minimizer, trying alternative approach');
-          }
-        }
-      });
+      // Remove CSS minimizer entirely to prevent breaking Tailwind CSS v4
+      if (config.optimization && config.optimization.minimizer) {
+        config.optimization.minimizer = config.optimization.minimizer.filter((plugin) => {
+          const pluginName = plugin?.constructor?.name || '';
+          const isCssMinimizer = pluginName === 'CssMinimizerPlugin' || 
+                                pluginName.includes('CssMinimizer') ||
+                                (plugin.constructor && plugin.constructor.toString().includes('CssMinimizer'));
+          
+          // Remove CSS minimizer - we'll let PostCSS handle optimization
+          return !isCssMinimizer;
+        });
+      }
 
       return {};
     },