Migrate from 3.x to 4.0
ReactPress 4.0 adds a plugin system, Electron desktop client, and theme catalog enhancements on top of 3.x. Existing full-stack 3.x sites upgrade with compatibility first.
Full overview: ReactPress 4.0 Extend.
Upgrade steps
npm i -g @fecommunity/reactpress
cd your-site
reactpress doctor
reactpress init # restart the stack if needed (SQLite by default)
Monorepo contributors:
git pull
pnpm install
pnpm run build:plugins
pnpm dev
CLI changes (important)
The 4.0 global CLI (@fecommunity/reactpress) is:
init · doctor · logs · stop
These commands are removed from the global CLI (you will be prompted to use init or Admin instead):
dev · theme · plugin · build · start · config · db · desktop · …
Manage themes and plugins in Admin. Full subcommands remain available in a Monorepo checkout.
New capabilities (optional)
Plugins
Admin → Plugins → install/enable hello-world or seo. In development, run pnpm run build:plugins first.
Desktop client
pnpm dev:desktop # SQLite + Admin + Electron
pnpm build:desktop # package installers
Local mode defaults to admin / admin, no Docker.
Official theme
init auto-installs the featured npm theme. You can also install reactpress-theme-starter under Admin → Appearance → Themes.
Monorepo:
reactpress theme add @fecommunity/reactpress-theme-starter@1.0.0-beta.0
Breaking changes
4.0 has no forced breaking config migration. If you used removed bundled themes (my-blog, twentytwentyfive), switch to hello-world or the official npm theme.
Default database moved from 3.x Docker MySQL to SQLite. For MySQL, see Project configuration and Docker deployment.