> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# 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](https://rspack.dev) for building, no longer supporting Webpack. Build configuration is aligned with [Rsbuild](https://v2.rsbuild.rs).
- **React Ecosystem Upgrade**: Full support for [React 19](https://react.dev/blog/2024/04/25/react-19) and [React Router v7](https://reactrouter.com).
- **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](/guides/get-started/glossary.md#csr) and [SSR](/guides/basic-features/render/ssr.md) projects.
- **Internationalization Enhancement**: Provides out-of-the-box [i18n plugin](/guides/advanced-features/international.md) to simplify internationalization development workflow.
- **SSG Capability Improvement**: Provides complete [Static Site Generation (SSG)](/guides/basic-features/render/ssg.md) support.
- **Route Configuration Enhancement**: Supports [config-based routing](/guides/basic-features/routes/config-routes.md), which can be used alone or combined with [convention-based routing](/guides/basic-features/routes/routes.md), providing more flexible route definition.

## Pre-upgrade Checklist

Before starting the upgrade, please confirm:

1. Your current project is using Modern.js 2.0
2. The React version is 17 or higher
3. 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](https://modernjs.dev)
- Search for related issues or submit a new issue in [GitHub Issues](https://github.com/web-infra-dev/modern.js/issues)
- Join the [Modern.js Discord community](https://discord.gg/modernjs) 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.