Your publishing platform — live in about a minute
One global install. Two commands. Site, admin, and API ready to go.

Report Bug · Request Feature · 中文文档 · Live Demo

---

Table of contents

• What is ReactPress?
• Quick start
• See it in action
• Highlights
• CLI reference
• Deploy
• Develop this repository
• Contributing

---

What is ReactPress?

ReactPress is a modern publishing platform for blogs, company sites, and content-driven products. Install the CLI once, run init and dev, and you get a public site, admin console, and API — without hand-writing config files or wiring a database yourself.

One backend, many fronts. Publish in one place; show content on the web, in admin, or through your own apps via the API.

3.0 overview · Upgrade from 2.x

---

Quick start

Prerequisites

Requirement	Notes
Node.js 18+	Required for the CLI
Docker	Recommended — default bundled MySQL runs in a container
MySQL	Optional — use your own instance instead of Docker

Install and run

npm i -g @fecommunity/reactpress@3
mkdir my-blog && cd my-blog
reactpress init
reactpress dev

When dev is ready, open the URLs printed in the terminal:

Service	Typical URL
Public site	http://localhost:3001
Admin	http://localhost:3001/admin
API health	http://localhost:3002/api/health

Tips

• Run reactpress with no arguments for the interactive menu.
• Run reactpress doctor or reactpress status if something does not look right.
• Upgrading from 2.x? See the migration guide.

---

See it in action

Usage demo

Install, initialize, start dev, and open your site — all from the terminal:

Screenshots

Admin dashboard	Demo site

---

Highlights

Topic	What you get
Go live fast	init + dev — guided setup, automatic database, URLs when ready
Publish & manage	Posts, pages, media, and site settings from the admin
Customize	Themes, light/dark mode, templates from minimal hello-world to full blog
Flexible runtime	All-in-one local dev, API-only headless mode, or production deploy
Developer experience	Interactive menu, doctor, status, and clear error messages

How it compares

	Traditional CMS	Static generators	ReactPress
Getting started	Server, plugins, manual setup	Repo + build per site	One CLI, ~1 minute to a working CMS
Content	Admin UI, coupled themes	Markdown in git	Admin UI + optional code-first workflows
Frontends	Theme/plugin ecosystem	Fixed at build time	One content hub, your choice of presentation
Best for	General blogs & business sites	Docs & marketing pages	Blogs, multi-site content, custom publishing flows

---

CLI reference

npm i -g @fecommunity/reactpress@3

Command	Description
reactpress	Interactive menu
reactpress init	Set up a new project (config + .env)
reactpress dev	Run site + admin + API locally
reactpress dev --api-only	API only — for custom frontends
reactpress doctor	Check your environment
reactpress status	See what is running
reactpress build	Production build
reactpress start	Run production build

More: documentation · Configuration

---

Deploy

npm i -g @fecommunity/reactpress@3
reactpress build
reactpress start

For PM2, Docker, and monorepo deployment details, see README-zh_CN.md and the docs.

---

Develop this repository

This repo is a monorepo (CLI, client, server, toolkit, templates). If you are contributing code here — not just using the published npm package — use pnpm and follow the full workflow in README-zh_CN.md:

pnpm install
pnpm run dev

---

Contributing

Thank you to everyone who has helped shape ReactPress — through code, documentation, issues, feedback, and early inspiration.

FECommunity	SleepSheep	fantasticit	chenbo29	redteav2	trashken	franz007	funtime1
scottdeift	TwoDollars666	Xiaonan2020	redtea	m0_37981569

You are welcome to join us.

1. Fork and clone the repo
2. pnpm install
3. pnpm run dev

Meaningful contributions are credited here after your PR is merged. See the Contributing Guide.

---

Acknowledgments

ReactPress builds on Next.js, NestJS, Ant Design, and TypeORM. Thank you to everyone who maintains the tools we rely on.

---

Star history