Introduction
Learning path (0 → 100)
Choose a starting point by role. Every doc includes an SEO summary and next-step links.
| Stage | Who you are | Start here |
|---|---|---|
| 0→1 | First time hearing about ReactPress | What is ReactPress? · Next.js blog in 60s · vs WordPress |
| 1→10 | Site owner / blogger | User guide → SEO settings |
| 10→50 | Frontend developer | Theme development → Headless API |
| 50→100 | Full-stack / contributor | Monorepo development → Plugin development |
| Go live | Operations | Production deployment → Docker |
| Troubleshoot | Hit a problem | FAQ → Troubleshooting |
Introduction
ReactPress is the publishing system for React developers — build blogs, documentation, company websites, and content-driven applications with React. One CLI ships CMS API, Web Admin, swappable Next.js themes, plugins, and an Electron desktop client.
ReactPress 4.0 (codename Extend) adds a plugin system, desktop client, and npm theme catalog on top of 3.x. New users: npm i -g @fecommunity/reactpress. See ReactPress 4.0 Extend. Install the desktop app: Desktop client. Still on 3.x? See ReactPress 3.0 Platform.
🆚 Comparison
Comparison of ReactPress, WordPress, and VuePress
| Feature | ReactPress | WordPress | VuePress |
|---|---|---|---|
| Technology Stack | React + Next.js + SQLite/MySQL + NestJS | PHP + MySQL | Vue.js |
| Type | Open-source publishing platform / CMS | Open-source publishing platform / CMS | Static site generator / Documentation tool |
| Front-end & Back-end Separation | Supported | Not supported (traditional approach) | Supported |
| Component-based Development | Supported | Limited support (via plugins and themes) | Supported |
| Performance Optimization | Virtual DOM, Code Splitting, Lazy Loading | Plugin-dependent optimization | Static page generation, excellent performance |
| SEO Performance | Excellent (SSR support) | Good | Outstanding (static pages) |
| Customizability | High (fully customizable themes and styles) | High (via plugins and themes) | Moderate (theme and component customization) |
| Extensibility | Strong (API, plugin hooks, independent front-end and back-end extensions) | Strong (plugin extensions) | Moderate (plugin and theme extensions) |
| User Interface | Modern, component-based design based on React | User-friendly backend interface | Minimalist, optimized for technical documentation |
| Security | Depends on the security of the framework and database | Depends on plugin and theme updates and maintenance | Static site, high security |
| Application Scenarios | Complex functionality, high concurrent access, SEO optimization needs | Quick website setup, content publishing, and management | Technical documentation, static blogs |
| User Groups | Developers, technical teams, Personal blogs, small businesses | Personal blogs, small businesses, startups | Technical documentation writers, developers |
| Community Support | Active and growing | Very active, with a large user base | Supported by the Vue.js community |
✨ Features
4.0 Extend
- 🔌 Plugins: Hooks +
plugin.json+ Admin UI slots; built-in SEO, auto-summary, batch WebP optimization - 🖥️ Desktop: Electron + SQLite local mode; connect remote API and sync content
- 🎨 Theme catalog: install official themes from npm in Admin (
initauto-installs the featured theme)
Platform (since 3.x)
- 📦 Single entry:
@fecommunity/reactpress—init,doctor,logs,stop - ⚡ Zero-config setup: auto-generated
.reactpress/config.json,.env, embedded SQLite - 🩺 Diagnostics:
reactpress doctorandreactpress logs - 🌈 Componentization with Ant Design
- 🌍 i18n (Chinese / English)
- 🌞 Light / dark theme
- 🖌️ Markdown editor, posts, categories, tags
- 📃 Pages, 💬 comments, 📷 media (local + OSS upload)
- 🔌 Headless: API Key, Webhook, health check, toolkit SDK
🔥 Live Demo
ReactPress Demo · Official theme demo
⌨️ Quick start (4.0 recommended)
End users — one global package
npm i -g @fecommunity/reactpress
mkdir my-blog && cd my-blog
reactpress init
init auto-starts API, Admin, and theme — no need to run reactpress dev (removed from the global CLI). Stop services with reactpress stop.
| Service | Port | URL |
|---|---|---|
| Admin | 3001 /admin/ | http://localhost:3001/admin/ |
| Site theme | 3001 | http://localhost:3001 |
| API | 3002 | http://localhost:3002/api/health |
| Theme preview | 3003 | http://localhost:3003 |
Run reactpress for the banner and help. Upgrade from 3.x: migration guide. From 2.x: 2.x → 3.0.
Desktop client (4.0, no Docker)
# at monorepo root
pnpm dev:desktop
Local SQLite mode, default account admin / admin. See ReactPress 4.0 Extend.
Monorepo contributors
git clone --depth=1 https://github.com/fecommunity/reactpress.git
cd reactpress
npm i -g pnpm
pnpm install
pnpm run dev
Node.js 20+ required. Default development uses SQLite (no Docker); optional pnpm docker:dev for embedded MySQL. pnpm run init prepares the environment without starting services. Run pnpm run build:plugins before plugin development.
📦 NPM Packages
| Package | Description |
|---|---|
| @fecommunity/reactpress | 4.0 main package (CLI + bundled API + plugins + desktop) |
| Desktop client | Download, local / remote modes, sync |
| ReactPress 4.0 Extend | 4.0 overview |
| ReactPress 3.0 Platform | 3.0 historical docs |
| @fecommunity/reactpress-toolkit | TypeScript API SDK (Headless) |
🔗 Links
- Home
- Desktop client
- 4.0 Extend
- 3.x → 4.0 migration
- 3.0 Platform
- 2.x → 3.0 migration
- Architecture (ARCHITECTURE.md)
- Issues
- Pull Request
We recommend How To Ask Questions The Smart Way and How to Report Bugs Effectively — better questions get better answers.
👥 Community
- Run
reactpress doctorandreactpress logsfirst - GitHub Issues
- GitHub Discussions
Email: admin@gaoredu.com
FAQ
What is ReactPress?
The publishing system for React developers — build blogs, documentation, company websites, and content-driven applications with React. CMS API, Web Admin, Next.js themes, plugins, and desktop client in one CLI.
Is ReactPress free?
Yes. MIT licensed. Install with npm i -g @fecommunity/reactpress.
ReactPress vs WordPress — which should I choose?
See the full ReactPress vs WordPress (2026) guide. Short answer: WordPress wins on plugin catalog and non-technical editors; ReactPress wins on React/Next.js stack, SSR SEO, and Headless-first architecture.
Can I migrate from WordPress?
Content can be migrated via export scripts or Headless API integration; themes must be rebuilt in Next.js. See FAQ and Headless API.
More answers: Full FAQ · About ReactPress · Contact