feat: enhance development toolkit

.gitignore

@@ -26,8 +26,8 @@ tsconfig.tsbuildinfo
 
 
 
-# Production
-build
+# Production (root output only; do not use bare `build` — toolkit/src/theme/build is source)
+/build
 
 # Generated files
 .docusaurus

CHANGELOG.md

@@ -1,13 +1,35 @@
+# [3.1.0](https://github.com/fecommunity/reactpress/compare/v3.0.0...v3.1.0) (2026-06-07)
+
+### Toolkit Theme Refactor
+
+* **Toolkit 3.1**: `@fecommunity/reactpress-toolkit` split into `theme` / `ui` / `app` / `plugin` submodules; theme manifest parsing, appearance config (Formily), SSR bootstrap, site settings & preview
+* **Export paths**: `package.json` exports add `./theme`, `./ui`, `./app`, `./plugin/*` subpaths for on-demand theme and plugin imports
+
+### CLI & Operations
+
+* **CLI 3.0.3**: `reactpress nginx` reverse proxy management; `reactpress db backup` supports Docker `mysqldump`; `reactpress build` target selection & step logging; improved interactive theming and error messages
+* **Fix**: enhanced monorepo root detection logic
+
+### Brand Assets
+
+* **Unified branding**: `public/brand/`, `public/favicon/`, and `public/icons/` centrally manage logo / favicon / PWA icons
+* **Export script**: `pnpm export:brand` syncs assets to server, web, cli, themes, and other directories
+
+### Docs & Other
+
+* **README**: added official theme section, Lighthouse performance metrics, and "Why ReactPress?" overview
+* **Theme schema**: `theme.manifest.schema.json` `$id` updated to `reactpress.surge.sh`
+
 # [3.0.0](https://github.com/fecommunity/reactpress/compare/v2.0.2...v3.0.0) (2026-05-17)
 
 ### Platform 3.0 — CLI-first Headless
 
-* **CLI**: 主包更名为 `@fecommunity/reactpress`；`reactpress dev` 就绪后输出前台/admin/API/Swagger 链接；`doctor`/`dev` 失败含可操作建议；CLI 多语言（`REACTPRESS_LANG` / `--lang`）；`reactpress-cli` bin deprecated
-* **Headless**: `GET /api/health`；API Key（`X-API-Key` + `/api/article/headless/list`）；Webhook（`article.published`、`comment.created`，HMAC 签名 + 3 次重试）
-* **内容**: 文章定时发布（`scheduledPublishAt`）；文章修订历史与回滚
-* **配置**: 根目录 `.env.example`；移除废弃 `.reactpress` 配置路径
-* **运维**: `cli/templates/docker-compose.prod.yml` 生产示例；`scripts/benchmark-cold-start.mjs` 二次冷启动验收
-* **Breaking**: `@fecommunity/reactpress-server` deprecated；主推 `@fecommunity/reactpress@3`；迁移见 [docs/migration-2-to-3.md](./docs/migration-2-to-3.md)
+* **CLI**: main package renamed to `@fecommunity/reactpress`; `reactpress dev` prints frontend/admin/API/Swagger URLs on ready; `doctor`/`dev` failures include actionable suggestions; CLI i18n (`REACTPRESS_LANG` / `--lang`); `reactpress-cli` bin deprecated
+* **Headless**: `GET /api/health`; API Key (`X-API-Key` + `/api/article/headless/list`); Webhooks (`article.published`, `comment.created`, HMAC signature + 3 retries)
+* **Content**: scheduled article publishing (`scheduledPublishAt`); article revision history & rollback
+* **Config**: root `.env.example`; removed deprecated `.reactpress` config path
+* **Ops**: `cli/templates/docker-compose.prod.yml` production example; `scripts/benchmark-cold-start.mjs` cold-start benchmark
+* **Breaking**: `@fecommunity/reactpress-server` deprecated; use `@fecommunity/reactpress@3`; see [docs/migration-2-to-3.md](./docs/migration-2-to-3.md)
 
 # [2.0.0-beta-4-beta.1](https://github.com/fecommunity/reactpress/compare/v2.0.1...v2.0.0-beta-4-beta.1) (2025-11-16)
 

README-zh_CN.md

@@ -1,6 +1,6 @@
 <div align="center">
   <a href="https://blog.gaoredu.com" title="ReactPress">
-    <img height="180" src="./public/logo.png" alt="ReactPress 标志">
+    <img height="72" src="./public/brand/logo.png" alt="ReactPress 标志">
   </a>
 
   <p align="center">

README.md

@@ -1,6 +1,6 @@
 <div align="center">
   <a href="https://blog.gaoredu.com" title="ReactPress">
-    <img height="180" src="./public/logo.png" alt="ReactPress Logo">
+    <img height="72" src="./public/brand/logo.png" alt="ReactPress Logo">
   </a>
 
   <p align="center">

docs/blog/changelog.md

@@ -1,13 +1,24 @@
 ---
 slug: changelog
 title: Changelog
-date: 2026-05-17
+date: 2026-06-07
 authors: [fecommunity]
 tags: [reactpress, release]
 ---
 
 <!--truncate-->
 
+## [3.1.0](https://github.com/fecommunity/reactpress/compare/v3.0.0...v3.1.0) (2026-06-07)
+
+**Toolkit theme refactor** — modular exports, first-class theme development.
+
+- **Toolkit 3.1**: split into `theme` / `ui` / `app` / `plugin` submodules; theme manifest, appearance config (Formily), SSR bootstrap, site settings & preview
+- **CLI 3.0.3**: `reactpress nginx` reverse proxy; Docker `mysqldump` in `db backup`; build target selection & step logging; improved UX
+- **Brand assets**: centralized `public/brand/` + `pnpm export:brand` to sync logos/favicons across server, web, cli, and themes
+- **Docs**: official theme section, Lighthouse scores; theme manifest schema URL updated
+
+---
+
 ## [3.0.0](https://github.com/fecommunity/reactpress/compare/v2.0.2...v3.0.0) (2026-05-17)
 
 **ReactPress 3.0 Platform** — one package, one command, your CMS in about a minute.

docs/i18n/zh/docusaurus-plugin-content-blog/changelog.md

@@ -1,13 +1,30 @@
 ---
 slug: changelog
 title: 更新日志
-date: 2026-05-17
+date: 2026-06-07
 authors: [fecommunity]
 tags: [reactpress, release]
 ---
 
 <!--truncate-->
 
+## [3.1.0](https://github.com/fecommunity/reactpress/compare/v3.0.0...v3.1.0) (2026-06-07)
+
+**Toolkit 主题化重构** — 模块化导出，主题开发一等公民。
+
+### 新特性
+
+- **Toolkit 3.1**：拆分为 `theme` / `ui` / `app` / `plugin` 子模块；主题 manifest 解析、外观配置（Formily）、SSR bootstrap、站点设置与预览
+- **CLI 3.0.3**：`reactpress nginx` 反向代理；`db backup` 支持 Docker 内 `mysqldump`；`build` 目标选择与分步日志；交互体验优化
+- **品牌资产**：`public/brand/` 集中管理 + `pnpm export:brand` 一键同步至各目录
+- **文档**：README 新增官方主题章节与 Lighthouse 性能指标
+
+### Bug Fixes
+
+- 增强 monorepo 根目录检测；主题 manifest schema URL 更新为 `reactpress.surge.sh`
+
+---
+
 ## [3.0.0](https://github.com/fecommunity/reactpress/compare/v2.0.2...v3.0.0) (2026-05-17)
 
 **ReactPress 3.0 平台版** — 装一个包，敲一条命令，一分钟拥有自己的 CMS。

docs/src/components/Home/Logo.tsx

@@ -1,40 +1,18 @@
-/**
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
+import useBaseUrl from '@docusaurus/useBaseUrl';
 import React from 'react';
 
 function Logo({ className }) {
+  const src = useBaseUrl('/img/logo.svg');
+
   return (
-    <svg
-      className={className}
+    <img
+      src={src}
       width={112}
       height={102}
-      fill="none"
-      xmlns="http://www.w3.org/2000/svg">
-      <path
-        d="M56 61.832c5.891 0 10.667-4.776 10.667-10.667S61.89 40.498 56 40.498c-5.89 0-10.666 4.776-10.666 10.667S50.108 61.832 56 61.832Z"
-        fill="var(--logo)"
-      />
-      <path
-        d="M56 75.165c29.455 0 53.333-10.745 53.333-24s-23.878-24-53.333-24-53.334 10.745-53.334 24 23.879 24 53.334 24Z"
-        stroke="var(--logo)"
-        strokeWidth={5.333}
-      />
-      <path
-        d="M35.215 63.165c14.728 25.509 35.972 40.815 47.451 34.188 11.48-6.628 8.846-32.68-5.882-58.188-14.727-25.51-35.972-40.816-47.45-34.188-11.48 6.627-8.846 32.679 5.881 58.188Z"
-        stroke="var(--logo)"
-        strokeWidth={5.333}
-      />
-      <path
-        d="M35.215 39.165c-14.727 25.509-17.36 51.56-5.882 58.188 11.48 6.627 32.724-8.68 47.451-34.188 14.728-25.51 17.362-51.56 5.883-58.188-11.48-6.628-32.724 8.679-47.452 34.188Z"
-        stroke="var(--logo)"
-        strokeWidth={5.333}
-      />
-    </svg>
+      alt="ReactPress"
+      className={className}
+      decoding="async"
+    />
   );
 }
 

package.json

@@ -39,7 +39,8 @@
     "test": "pnpm --dir cli test",
     "test:cli": "pnpm --dir cli test",
     "test:smoke": "node scripts/smoke-api-health.mjs",
-    "test:benchmark": "node scripts/benchmark-cold-start.mjs"
+    "test:benchmark": "node scripts/benchmark-cold-start.mjs",
+    "export:brand": "node scripts/export-brand-assets.mjs"
   },
   "dependencies": {
     "@fecommunity/reactpress": "workspace:*"
@@ -48,6 +49,7 @@
     "husky": "^7.0.4",
     "lint-staged": "^12.4.1",
     "prettier": "^2.3.2",
+    "to-ico": "^1.1.5",
     "typescript": "~4.1.6"
   }
 }