@fecommunity/reactpress 2.0.0-beta.0 → 3.0.1

package/LICENSE

@@ -1,21 +1,21 @@
 MIT License
- 
-Copyright (c) [2024] [fecommunity]
- 
+
+Copyright (c) 2026 FECommunity
+
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights
 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 copies of the Software, and to permit persons to whom the Software is
 furnished to do so, subject to the following conditions:
- 
+
 The above copyright notice and this permission notice shall be included in all
 copies or substantial portions of the Software.
- 
+
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

package/README.md

@@ -1,195 +1,47 @@
-<div align="center">
-  <a href="https://gaoredu.com" title="ReactPress">
-    <img height="180" src="./public/logo.png" alt="ReactPress Logo">
-  </a>
+# @fecommunity/reactpress-cli
 
-  <h1>ReactPress 2.0</h1>
+零配置一键初始化与管理 ReactPress CMS & 博客服务器。内置 NestJS 服务端，无需单独克隆 [fecommunity/reactpress](https://github.com/fecommunity/reactpress)。
 
-  <p align="center">
-    <em>Modern Full-Stack Publishing Platform Built with React, Next.js, and NestJS</em>
-  </p>
+完整文档与贡献指南见：[github.com/fecommunity/reactpress-cli](https://github.com/fecommunity/reactpress-cli)
 
-  [![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/fecommunity/reactpress/blob/master/LICENSE)
-  [![NPM Version](https://img.shields.io/npm/v/@fecommunity/reactpress.svg?style=flat-square)](https://www.npmjs.com/package/@fecommunity/reactpress)
-  [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/fecommunity/reactpress/pulls)
-  [![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg?style=flat-square)](http://www.typescriptlang.org/)
-  [![Next.js](https://img.shields.io/badge/Next.js-14-black?style=flat-square)](https://nextjs.org/)
-  [![NestJS](https://img.shields.io/badge/NestJS-10-red?style=flat-square)](https://nestjs.com/)
-  [![Deploy](https://img.shields.io/badge/Deploy-Vercel-blue?style=flat-square)](https://vercel.com/new/clone?repository-url=https://github.com/fecommunity/reactpress)
-  [![CI](https://github.com/fecommunity/reactpress/actions/workflows/npm-publish.yml/badge.svg)](https://github.com/fecommunity/reactpress/actions/workflows/npm-publish.yml)
+## 安装
 
-  <p>
-    <a href="https://github.com/fecommunity/reactpress/issues">Report Bug</a>
-    ·
-    <a href="https://github.com/fecommunity/reactpress/issues">Request Feature</a>
-    ·
-    <a href="./README-zh_CN.md">中文文档</a>
-  </p>
-</div>
-
-## 🌟 Modern Publishing Platform
-
-**ReactPress 2.0** is a full-stack publishing platform built with modern web technologies. It enables developers and content creators to build professional blogs, websites, and content management systems with minimal setup.
-
-[![ReactPress Poster](./public/poster.png)](https://gaoredu.com)
-
-## ✨ Key Features
-
-### ⚡ 5-Minute Installation
-- **Zero-Configuration Setup** with intelligent defaults
-- **WordPress-Style Installation Wizard** for intuitive setup
-- **Auto-Database Provisioning** with automatic schema migration
-
-### 🎨 Advanced Customization
-- **Dynamic Theme Switching** with light/dark mode
-- **Component-Level Customization** through modular architecture
-- **Internationalization** support (Chinese & English)
-
-### 🔧 Unified Development Experience
-- **Monorepo Architecture** with modular packages
-- **TypeScript** for type safety across frontend and backend
-- **PM2 Process Management** for production deployments
-
-### 🚀 Modern Technology Stack
-- **Frontend**: React 18 + Next.js 14 App Router
-- **Backend**: NestJS 10 with modular architecture
-- **Database**: MySQL with TypeORM
-- **UI**: Ant Design v5 components
-
-## 📸 Screenshots
-
-### Installation Wizard
-[![Installation](./public/install.png)](https://gaoredu.com)
-
-### Content Management Dashboard
-[![Admin Dashboard](./public/admin.png)](https://gaoredu.com)
-
-### Demo Site
-[![Demo](./public/demo.png)](https://gaoredu.com)
-
-## 🚀 Quick Start
-
-### 🏁 Installation Options
-
-#### Option 1: Unified CLI (Recommended)
 ```bash
-# Install ReactPress globally
-npm install -g @fecommunity/reactpress
-
-# Launch installation wizard
-reactpress server install
-
-# Start services
-reactpress server start
-reactpress client
+npm install -g @fecommunity/reactpress-cli
 ```
 
-#### Option 2: Independent Services
-```bash
-# Install and start ReactPress server
-npx @fecommunity/reactpress-server
-
-# Install and run client independently
-npx @fecommunity/reactpress-client
-```
-
-## 📦 Packages & Components
-
-ReactPress is organized as a **monorepo with modular packages**:
-
-### Core Packages
+全局命令为 `reactpress-cli`（与 npm 包名无关）。
 
-| Package | Description | Version |
-|---------|-------------|---------|
-| [`@fecommunity/reactpress`](.) | Main CLI and unified entry point | 2.0.0 |
-| [`@fecommunity/reactpress-client`](./client) | Next.js 14 frontend application | 1.0.0 |
-| [`@fecommunity/reactpress-server`](./server) | NestJS 10 backend API | 1.0.0 |
-| [`@fecommunity/reactpress-toolkit`](./toolkit) | Auto-generated API client SDK | 1.0.0 |
+> npm 上的无作用域包名 `reactpress-cli` 已被占用，本包发布为 `@fecommunity/reactpress-cli`。
 
-### Templates
+## 快速开始
 
-| Template | Description | Package Name |
-|----------|-------------|--------------|
-| [`hello-world`](./templates/hello-world) | Minimal template for rapid prototyping | `@fecommunity/reactpress-template-hello-world` |
-| [`twentytwentyfive`](./templates/twentytwentyfive) | Feature-rich blog template | `@fecommunity/reactpress-template-twentytwentyfive` |
-
-## 🔧 Configuration
-
-Create a `.env` file in the root directory for local development:
-
-```env
-# Database Config
-DB_HOST=127.0.0.1
-DB_PORT=3306
-DB_USER=reactpress
-DB_PASSWD=reactpress
-DB_DATABASE=reactpress
-
-# Client Config
-CLIENT_SITE_URL=http://localhost:3001
-
-# Server Config
-SERVER_SITE_URL=http://localhost:3002
-```
-
-## 🚀 Deployment Options
-
-### Deploy with Vercel (Recommended for Startups)
-[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/fecommunity/reactpress)
-
-### PM2 Deployment (Recommended for Production)
-```bash
-# Install PM2 globally
-npm install -g pm2
-
-# Start ReactPress server with PM2
-npx @fecommunity/reactpress-server --pm2
-
-# Start ReactPress client with PM2
-npx @fecommunity/reactpress-client --pm2
-```
-
-### Traditional Deployment (Self-Managed)
 ```bash
-# Build for production
-pnpm run build
-
-# Start production servers
-pnpm run start
+mkdir my-blog && cd my-blog
+reactpress-cli init
+reactpress-cli start
 ```
 
-## 🤝 Contributing
-
-We welcome contributions of all kinds! Whether it's bug fixes, new features, documentation improvements, or translations, your help is appreciated.
-
-### 📋 Development Setup
-
-1. Fork the repository
-2. Clone your fork: `git clone https://github.com/your-username/reactpress.git`
-3. Install dependencies: `pnpm install`
-4. Start development servers: `pnpm run dev`
-
-### 📦 Publishing
-
-To publish packages to npm:
-
-1. Ensure you're logged into npm: `pnpm login`
-2. Run the publish script: `pnpm run publish`
-3. Follow the interactive prompts to select packages and version increments
-
-Please read our [Contributing Guide](https://github.com/fecommunity/reactpress/blob/master/CONTRIBUTING.md) for details on our code of conduct and development process.
+浏览器访问 `http://localhost:3002`（API 文档：`/api`）。
 
-## ❤️ Acknowledgments
+## 常用命令
 
-ReactPress is inspired by and built upon the work of many amazing open-source projects:
+| 命令 | 说明 |
+|------|------|
+| `reactpress-cli init [dir]` | 初始化项目 |
+| `reactpress-cli start` | 启动服务（自动准备数据库） |
+| `reactpress-cli stop` | 停止服务 |
+| `reactpress-cli restart` | 重启服务 |
+| `reactpress-cli status` | 查看状态 |
+| `reactpress-cli config [key] [value]` | 查看/修改配置 |
+| `reactpress-cli config server.port 3003 --apply` | 改端口并重启 |
 
-- [Next.js](https://github.com/vercel/next.js) - React framework
-- [NestJS](https://github.com/nestjs/nest) - Progressive Node.js framework
-- [Ant Design](https://github.com/ant-design/ant-design) - UI design language
-- [TypeORM](https://github.com/typeorm/typeorm) - ORM for TypeScript and JavaScript
+## 要求
 
-We're grateful to the authors and contributors of these projects for their excellent work.
+- Node.js 18+
+- macOS / Linux / Windows
+- 默认使用 Docker 运行嵌入式 MySQL；也可在 `.reactpress/config.json` 中配置外部数据库
 
-## 📈 Star History
+## 许可证
 
-[![Star History Chart](https://api.star-history.com/svg?repos=fecommunity/reactpress&type=Date)](https://star-history.com/#fecommunity/reactpress&Date)
+MIT © FECommunity

package/bin/reactpress-cli-shim.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+
+/**
+ * @deprecated 3.0 起请使用 `reactpress`（@fecommunity/reactpress）。3.1 将移除此 bin。
+ */
+const chalk = require('chalk');
+const { t } = require('../lib/i18n');
+
+function mapLegacyArgv(argv) {
+  const [cmd, ...rest] = argv;
+  if (cmd === 'start') return ['server', 'start', ...rest];
+  if (cmd === 'stop') return ['server', 'stop', ...rest];
+  if (cmd === 'restart') return ['server', 'restart', ...rest];
+  if (cmd === 'status') return ['server', 'status', ...rest];
+  return argv;
+}
+
+if (!process.env.REACTPRESS_SUPPRESS_DEPRECATION) {
+  console.warn(
+    chalk.yellow(
+      t('shim.deprecated')
+    )
+  );
+}
+
+const mapped = mapLegacyArgv(process.argv.slice(2));
+process.argv = [process.argv[0], process.argv[1], ...mapped];
+require('./reactpress.js');

package/bin/reactpress.js

@@ -1,90 +1,274 @@
 #!/usr/bin/env node
 
 /**
- * ReactPress CLI - Main entry point for all ReactPress commands
- * This script allows users to run reactpress commands after installing the package globally
+ * ReactPress unified CLI — init, dev, build, server, docker, publish.
+ * Run without arguments for an interactive menu (Claude Code–style).
  */
 
 const { Command } = require('commander');
-const { spawn } = require('child_process');
 const path = require('path');
 const chalk = require('chalk');
+const { ensureOriginalCwd, getMonorepoRoot } = require('../lib/root');
+const { ensureProjectEnvironment, initMonorepoProject } = require('../lib/bootstrap');
+const { runDev } = require('../lib/dev');
+const { runApiDev } = require('../lib/api-dev');
+const { runLifecycleCommand } = require('../lib/lifecycle');
+const { runDockerCommand } = require('../lib/docker');
+const { printUnifiedStatus } = require('../lib/status');
+const { runDoctor } = require('../lib/doctor');
+const { runDbBackup } = require('../lib/db-backup');
+const { runBuild } = require('../lib/build');
+const { startApiWithPm2 } = require('../lib/pm2');
+const { runNodeScript, runReactpressCli } = require('../lib/spawn');
+const { getClientBin } = require('../lib/paths');
+const { runInteractiveLoop } = require('../ui/interactive');
+const { t } = require('../lib/i18n');
+
+const rootPkg = require(path.join(getMonorepoRoot(), 'package.json'));
 
-// Create the CLI program
 const program = new Command();
 
-// Get the directory where this script is located
-const binDir = __dirname;
-const rootDir = path.join(binDir, '..');
+program
+  .name('reactpress')
+  .description(t('cli.description'))
+  .version(rootPkg.version);
 
-// Server command
 program
-  .command('server')
-  .description('Manage the ReactPress server')
-  .option('install', 'Launch the installation wizard')
-  .option('start', 'Start the ReactPress server')
-  .option('--pm2', 'Start server with PM2 process manager')
-  .action((options) => {
-    const serverScript = path.join(rootDir, 'scripts', 'reactpress-server.js');
-    
-    let args = [];
-    if (options.install) {
-      args.push('install');
-    } else if (options.start) {
-      args.push('start');
+  .command('init')
+  .description(t('cli.init.description'))
+  .argument('[directory]', t('cli.init.directory'), '.')
+  .option('-f, --force', t('cli.init.force'))
+  .action(async (directory, options) => {
+    const projectRoot = path.resolve(directory);
+    process.env.REACTPRESS_ORIGINAL_CWD = projectRoot;
+    const { isMonorepoCheckout } = require('../lib/bootstrap');
+    if (isMonorepoCheckout(projectRoot)) {
+      const result = await initMonorepoProject(projectRoot, { force: !!options.force });
+      console.log(`[reactpress] ${result.message}`);
+      process.exit(result.ok ? 0 : 1);
+      return;
     }
-    
-    if (options.pm2) {
-      args.push('--pm2');
+    const args = ['init', directory];
+    if (options.force) args.push('--force');
+    runReactpressCli(args, { cwd: projectRoot });
+  });
+
+program
+  .command('dev')
+  .description(t('cli.dev.description'))
+  .option('--api-only', t('cli.dev.apiOnly'))
+  .option('--client-only', t('cli.dev.clientOnly'))
+  .action(async (options) => {
+    const projectRoot = ensureOriginalCwd();
+    try {
+      if (options.clientOnly) {
+        await runNodeScript(getClientBin(), [], { cwd: projectRoot });
+        return;
+      }
+      if (options.apiOnly) {
+        await runApiDev(projectRoot);
+        return;
+      }
+      await runDev(projectRoot);
+    } catch (err) {
+      console.error(chalk.red('[reactpress]'), err.message || err);
+      process.exit(err.exitCode ?? 1);
     }
-    
-    const serverProcess = spawn('node', [serverScript, ...args], {
-      stdio: 'inherit'
-    });
-    
-    serverProcess.on('error', (error) => {
-      console.error(chalk.red('[ReactPress CLI] Failed to start server:'), error);
+  });
+
+const serverCmd = program.command('server').description(t('cli.server.description'));
+
+serverCmd
+  .command('start')
+  .description(t('cli.server.start.description'))
+  .option('--pm2', t('cli.server.start.pm2'))
+  .option('--bg', t('cli.server.start.bg'))
+  .action(async (options) => {
+    const projectRoot = ensureOriginalCwd();
+    try {
+      if (options.pm2) {
+        await startApiWithPm2(projectRoot);
+        return;
+      }
+      const cmd = options.bg ? 'start:bg' : 'start';
+      const code = await runLifecycleCommand(cmd, projectRoot);
+      process.exit(code ?? 0);
+    } catch (err) {
+      console.error(chalk.red('[reactpress]'), err.message || err);
       process.exit(1);
-    });
+    }
+  });
+
+serverCmd.command('stop').description(t('cli.server.stop')).action(async () => {
+  const code = await runLifecycleCommand('stop', ensureOriginalCwd());
+  process.exit(code ?? 0);
+});
+
+serverCmd.command('restart').description(t('cli.server.restart')).action(async () => {
+  const code = await runLifecycleCommand('restart', ensureOriginalCwd());
+  process.exit(code ?? 0);
+});
+
+serverCmd.command('status').description(t('cli.server.status')).action(async () => {
+  await runLifecycleCommand('status', ensureOriginalCwd());
+});
+
+const clientCmd = program.command('client').description(t('cli.client.description'));
+
+clientCmd
+  .command('start')
+  .description(t('cli.client.start'))
+  .option('--pm2', t('cli.client.start.pm2'))
+  .action(async (options) => {
+    const args = options.pm2 ? ['--pm2'] : [];
+    await runNodeScript(getClientBin(), args, { cwd: ensureOriginalCwd() });
   });
 
-// Client command
 program
-  .command('client')
-  .description('Manage the ReactPress client')
-  .option('--pm2', 'Start client with PM2 process manager')
-  .action((options) => {
-    const clientScript = path.join(rootDir, 'client', 'bin', 'reactpress-client.js');
-    
-    let args = [];
-    if (options.pm2) {
-      args.push('--pm2');
+  .command('build')
+  .description(t('cli.build.description'))
+  .option('-t, --target <target>', t('cli.build.target'), 'all')
+  .action(async (options) => {
+    try {
+      await runBuild(options.target, ensureOriginalCwd());
+    } catch (err) {
+      console.error(chalk.red('[reactpress]'), err.message || err);
+      process.exit(1);
     }
-    
-    const clientProcess = spawn('node', [clientScript, ...args], {
-      stdio: 'inherit'
-    });
-    
-    clientProcess.on('error', (error) => {
-      console.error(chalk.red('[ReactPress CLI] Failed to start client:'), error);
+  });
+
+const dockerCmd = program.command('docker').description(t('cli.docker.description'));
+
+dockerCmd
+  .command('up')
+  .description(t('cli.docker.up'))
+  .action(async () => {
+    await runDockerCommand('up', ensureOriginalCwd());
+  });
+
+dockerCmd
+  .command('down')
+  .alias('stop')
+  .description(t('cli.docker.down'))
+  .action(async () => {
+    await runDockerCommand('down', ensureOriginalCwd());
+  });
+
+dockerCmd
+  .command('start')
+  .description(t('cli.docker.start'))
+  .action(async () => {
+    await runDockerCommand('start', ensureOriginalCwd());
+  });
+
+dockerCmd.command('restart').description(t('cli.docker.restart')).action(async () => {
+  await runDockerCommand('restart', ensureOriginalCwd());
+});
+
+dockerCmd.command('status').description(t('cli.docker.status')).action(async () => {
+  await runDockerCommand('status', ensureOriginalCwd());
+});
+
+dockerCmd
+  .command('logs [service]')
+  .description(t('cli.docker.logs'))
+  .action(async (service) => {
+    await runDockerCommand('logs', ensureOriginalCwd(), service ? [service] : []);
+  });
+
+program
+  .command('status')
+  .description(t('cli.status.description'))
+  .action(async () => {
+    await printUnifiedStatus(ensureOriginalCwd());
+  });
+
+program
+  .command('doctor')
+  .description(t('cli.doctor.description'))
+  .action(async () => {
+    const code = await runDoctor(ensureOriginalCwd());
+    process.exit(code);
+  });
+
+const dbCmd = program.command('db').description(t('cli.db.description'));
+
+dbCmd
+  .command('backup')
+  .description(t('cli.db.backup'))
+  .option('-o, --output <file>', t('cli.db.backup.output'))
+  .action(async (options) => {
+    try {
+      await runDbBackup(ensureOriginalCwd(), options.output);
+    } catch (err) {
+      console.error(chalk.red('[reactpress]'), err.message || err);
       process.exit(1);
-    });
+    }
+  });
+
+program
+  .command('publish')
+  .description(t('cli.publish.description'))
+  .option('--build', t('cli.publish.build'))
+  .option('--publish', t('cli.publish.publish'))
+  .action(async (options) => {
+    const prev = process.argv.slice();
+    const args = [process.argv[0], process.argv[1]];
+    if (options.build) args.push('--build');
+    else if (options.publish) args.push('--publish');
+    else args.push('--publish');
+    process.argv = args;
+    try {
+      await require('../lib/publish').main();
+    } catch (err) {
+      console.error(chalk.red('[reactpress]'), err.message || err);
+      process.exit(1);
+    } finally {
+      process.argv = prev;
+    }
   });
 
-// Set the version from package.json
-const packageJson = require(path.join(rootDir, 'package.json'));
-program.version(packageJson.version);
+program
+  .command('start')
+  .description(t('cli.start.description'))
+  .action(async () => {
+    const projectRoot = ensureOriginalCwd();
+    const { spawn } = require('child_process');
+    const code = await runLifecycleCommand('start', projectRoot);
+    if (code !== 0) process.exit(code);
+    const child = spawn('pnpm', ['run', '--dir', './client', 'start'], {
+      stdio: 'inherit',
+      shell: true,
+      cwd: projectRoot,
+    });
+    child.on('close', (c) => process.exit(c ?? 0));
+  });
 
-// Configure help text
 program.on('--help', () => {
   console.log('');
-  console.log('For more information, visit: https://github.com/fecommunity/reactpress');
+  console.log(chalk.gray(t('cli.help.examples')));
+  console.log(t('cli.help.interactive'));
+  console.log(t('cli.help.dev'));
+  console.log(t('cli.help.init'));
+  console.log(t('cli.help.server'));
+  console.log(t('cli.help.status'));
+  console.log(t('cli.help.doctor'));
+  console.log(t('cli.help.docker'));
+  console.log(t('cli.help.build'));
+  console.log(t('cli.help.publish'));
+  console.log('');
 });
 
-// Parse the command line arguments
-program.parse(process.argv);
+async function main() {
+  const argv = process.argv.slice(2);
+  if (argv.length === 0) {
+    await runInteractiveLoop();
+    return;
+  }
+  program.parse(process.argv);
+}
 
-// If no command is provided, show help
-if (!process.argv.slice(2).length) {
-  program.outputHelp();
-}
+main().catch((err) => {
+  console.error(chalk.red('[reactpress]'), err.message || err);
+  process.exit(1);
+});

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+export declare function createProgram(): Command;
+export declare function runCli(argv?: string[]): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuBpC,wBAAgB,aAAa,IAAI,OAAO,CAiFvC;AAED,wBAAsB,MAAM,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzE"}