Overview
This guide will help you upgrade from Modern.js 2.0 to Modern.js 3.0.
Upgrade Overview
Modern.js 3.0 brings significant improvements and changes, including:
- Build Tool Upgrade: Default use of Rspack for building, no longer supporting Webpack. Build configuration is aligned with Rsbuild.
- React Ecosystem Upgrade: Full support for React 19 and React Router v7.
- Plugin System Refactoring: Redesigned plugin API, supporting custom plugins at CLI, Runtime, and Server layers to extend framework capabilities.
- React Server Component: Support for using React Server Component in CSR and SSR projects.
- Internationalization Enhancement: Provides out-of-the-box i18n plugin to simplify internationalization development workflow.
- SSG Capability Improvement: Provides complete Static Site Generation (SSG) support.
- Route Configuration Enhancement: Supports config-based routing, which can be used alone or combined with convention-based routing, providing more flexible route definition.
Pre-upgrade Checklist
Before starting the upgrade, please confirm:
- Your current project is using Modern.js 2.0
- The React version is 17 or higher
- The Node.js version is 18.20.8 or higher. We recommend using Node.js 22 or higher
Getting Help
If you encounter any issues during the upgrade process, you can get help through the following channels:
- Check the Modern.js official documentation
- Search for related issues or submit a new issue in GitHub Issues
- Join the Modern.js Discord community to communicate with other developers
We recommend providing as much detail as possible when submitting an issue, including error logs, configuration files, and reproduction steps, to help resolve issues faster.