ReactPress Architecture in Detail

Architecture in Detail

ReactPress separates content management (NestJS + MySQL + admin) from presentation (visitor themes). The REST API is the contract between both sides.

Request flow (headless mode)

1. Editor publishes an article in the admin console.
2. NestJS persists content to MySQL and exposes it at GET /api/article/:id.
3. Theme Starter fetches via themeApi during SSR and renders App Router pages with ISR.
4. Browser receives HTML; subsequent navigations hydrate client components from the toolkit.

Monorepo packages

• CLI — project lifecycle and local orchestration
• Server — NestJS modules for articles, categories, tags, pages, comments, knowledge, media
• Client — bundled admin and default visitor UI
• Toolkit — @fecommunity/reactpress-toolkit for third-party themes
• Theme Starter — reference headless implementation (this repository)

Headless entry point

Run reactpress dev --api-only when you only need the API and connect a custom theme such as Theme Starter with pnpm dev.

Documentation: reactpress.surge.sh