3.x → 4.0 Migration Guide
ReactPress 4.0 adds a plugin system, Electron desktop client, and theme catalog enhancements on top of 3.x. Upgrading an existing 3.x full-stack site is compatibility-first.
See ReactPress 4.0 Extend for the full overview.
Upgrade steps
npm i -g @fecommunity/reactpress@beta
cd your-site
reactpress doctor
Monorepo contributors:
git pull
pnpm install
pnpm run build:plugins
pnpm dev
New capabilities (optional)
Plugins
Admin → Plugins → install/enable hello-world or seo. Run pnpm run build:plugins in development first.
Desktop client
pnpm dev:desktop # dev: SQLite + Admin + Electron
pnpm build:desktop # build installer
Local mode defaults to admin / admin — no Docker required.
Official themes
reactpress theme add @fecommunity/reactpress-theme-starter@1.0.0-beta.0
Breaking changes
4.0 has no mandatory breaking config migration. If you used removed bundled themes (my-blog, twentytwentyfive), switch to hello-world or an npm official theme.