Update docs for v9.1.1 release and add export utility documentation

justin808 · justin808 · commit 8cfb76b141a2 · 2025-10-08T22:19:12.000-10:00
- Set release date for v9.1.1 as October 9, 2025
- Add note about switch_bundler integration in CHANGELOG
- Add Debugging Configuration section to README
- Add config export utility to rspack migration guide with comparison workflow
- Document integration with switch_bundler feature
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -11,6 +11,8 @@
 
 Changes since the last non-beta release.
 
+## [v9.1.1] - October 9, 2025
+
 ### Added
 
 - **New config export utility for debugging webpack/rspack configurations** [PR #647](https://github.com/shakacode/shakapacker/pull/647) by [justin808](https://github.com/justin808).
@@ -27,6 +29,7 @@ Changes since the last non-beta release.
     - Sanitizes filenames to prevent path traversal
     - Helpful `.gitignore` suggestions
   - **Usage:** `bin/export-bundler-config --doctor` or `bundle exec rake shakapacker:export_bundler_config`
+  - Works seamlessly with `rake shakapacker:switch_bundler` for comparing webpack vs rspack configs
   - Lays groundwork for future config diff feature (tracked in [#667](https://github.com/shakacode/shakapacker/issues/667))
 
 ### Fixed
diff --git a/README.md b/README.md
@@ -767,6 +767,27 @@ Please note that if you want opt-in to use esbuild-loader, you can skip [React](
 
 To switch between Babel, SWC, or esbuild, or to configure environment-specific transpiler settings, see the [Transpiler Migration Guide](./docs/transpiler-migration.md).
 
+### Debugging Configuration
+
+Shakapacker provides a powerful utility to export and analyze your webpack/rspack configuration:
+
+```bash
+# Export all configs for troubleshooting (recommended)
+bin/export-bundler-config --doctor
+
+# Or via rake task
+bundle exec rake shakapacker:export_bundler_config -- --doctor
+```
+
+This exports development and production configurations for both client and server bundles to `shakapacker-config-exports/` directory in annotated YAML format. Perfect for:
+
+- Debugging configuration issues
+- Comparing webpack vs rspack configs (works with `rake shakapacker:switch_bundler`)
+- Understanding differences between development and production
+- Analyzing client vs server bundle configurations
+
+For more options and usage examples, see the [Troubleshooting Guide](./docs/troubleshooting.md#exporting-webpack--rspack-configuration).
+
 ### Integrations
 
 Shakapacker out of the box supports JS and static assets (fonts, images etc.) compilation. To enable support for CoffeeScript or TypeScript install relevant packages:
diff --git a/docs/rspack_migration_guide.md b/docs/rspack_migration_guide.md
@@ -269,6 +269,34 @@ bin/shakapacker --mode production
 3. **Enable Caching:** Rspack has built-in persistent caching
 4. **Use SWC:** The built-in SWC loader is significantly faster than Babel
 
+## Debugging Configuration
+
+To compare your webpack and rspack configurations during migration:
+
+```bash
+# Export webpack configs before switching
+bin/export-bundler-config --doctor
+
+# Switch to rspack
+rails shakapacker:switch_bundler rspack --install-deps
+
+# Export rspack configs to compare
+bin/export-bundler-config --doctor
+
+# Compare the files in shakapacker-config-exports/
+diff shakapacker-config-exports/webpack-production-client.yaml \
+     shakapacker-config-exports/rspack-production-client.yaml
+```
+
+The config export utility creates annotated YAML files that make it easy to:
+
+- Verify plugin replacements are correct
+- Compare loader configurations
+- Identify missing or different options
+- Debug configuration issues
+
+See the [Troubleshooting Guide](./troubleshooting.md#exporting-webpack--rspack-configuration) for more details.
+
 ## Resources
 
 - [Rspack Documentation](https://rspack.rs)
