Skip to main content

Introduction

Learning path (0 → 100)

Choose a starting point by role. Every doc includes an SEO summary and next-step links.

StageWho you areStart here
0→1First time hearing about ReactPressWhat is ReactPress? · Next.js blog in 60s · vs WordPress
1→10Site owner / bloggerUser guideSEO settings
10→50Frontend developerTheme developmentHeadless API
50→100Full-stack / contributorMonorepo developmentPlugin development
Go liveOperationsProduction deploymentDocker
TroubleshootHit a problemFAQTroubleshooting

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

FeatureReactPressWordPressVuePress
Technology StackReact + Next.js + SQLite/MySQL + NestJSPHP + MySQLVue.js
TypeOpen-source publishing platform / CMSOpen-source publishing platform / CMSStatic site generator / Documentation tool
Front-end & Back-end SeparationSupportedNot supported (traditional approach)Supported
Component-based DevelopmentSupportedLimited support (via plugins and themes)Supported
Performance OptimizationVirtual DOM, Code Splitting, Lazy LoadingPlugin-dependent optimizationStatic page generation, excellent performance
SEO PerformanceExcellent (SSR support)GoodOutstanding (static pages)
CustomizabilityHigh (fully customizable themes and styles)High (via plugins and themes)Moderate (theme and component customization)
ExtensibilityStrong (API, plugin hooks, independent front-end and back-end extensions)Strong (plugin extensions)Moderate (plugin and theme extensions)
User InterfaceModern, component-based design based on ReactUser-friendly backend interfaceMinimalist, optimized for technical documentation
SecurityDepends on the security of the framework and databaseDepends on plugin and theme updates and maintenanceStatic site, high security
Application ScenariosComplex functionality, high concurrent access, SEO optimization needsQuick website setup, content publishing, and managementTechnical documentation, static blogs
User GroupsDevelopers, technical teams, Personal blogs, small businessesPersonal blogs, small businesses, startupsTechnical documentation writers, developers
Community SupportActive and growingVery active, with a large user baseSupported 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 (init auto-installs the featured theme)

Platform (since 3.x)

  • 📦 Single entry: @fecommunity/reactpressinit, doctor, logs, stop
  • Zero-config setup: auto-generated .reactpress/config.json, .env, embedded SQLite
  • 🩺 Diagnostics: reactpress doctor and reactpress 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

End users — one global package

npm i -g @fecommunity/reactpress
mkdir my-blog && cd my-blog
reactpress init
4.0 note

init auto-starts API, Admin, and theme — no need to run reactpress dev (removed from the global CLI). Stop services with reactpress stop.

ServicePortURL
Admin3001 /admin/http://localhost:3001/admin/
Site theme3001http://localhost:3001
API3002http://localhost:3002/api/health
Theme preview3003http://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

PackageDescription
@fecommunity/reactpress4.0 main package (CLI + bundled API + plugins + desktop)
Desktop clientDownload, local / remote modes, sync
ReactPress 4.0 Extend4.0 overview
ReactPress 3.0 Platform3.0 historical docs
@fecommunity/reactpress-toolkitTypeScript API SDK (Headless)

We recommend How To Ask Questions The Smart Way and How to Report Bugs Effectively — better questions get better answers.

👥 Community

  1. Run reactpress doctor and reactpress logs first
  2. GitHub Issues
  3. 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