@fecommunity/reactpress 2.0.0-beta-4-beta.1

package/CONTRIBUTING.md

@@ -0,0 +1,122 @@
+# Contributing to ReactPress
+
+Thank you for your interest in contributing to ReactPress! We welcome contributions from the community to help improve the project.
+
+## Code of Conduct
+
+Please read and follow our [Code of Conduct](CODE_OF_CONDUCT.md) to ensure a welcoming and inclusive environment for all contributors.
+
+## Getting Started
+
+1. Fork the repository
+2. Clone your fork: `git clone https://github.com/your-username/reactpress.git`
+3. Create a new branch: `git checkout -b feature/your-feature-name`
+4. Make your changes
+5. Commit your changes: `git commit -m "Add your feature description"`
+6. Push to your fork: `git push origin feature/your-feature-name`
+7. Create a pull request
+
+## Development Setup
+
+### Prerequisites
+
+- Node.js >= 16.5.0
+- pnpm >= 7.0.0
+- MySQL 5.7 or higher
+
+### Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/fecommunity/reactpress.git
+cd reactpress
+
+# Install dependencies
+pnpm install
+
+# Start development servers
+pnpm run dev
+```
+
+## Project Structure
+
+ReactPress follows a monorepo structure:
+
+```
+reactpress/
+├── client/          # Next.js frontend application
+├── server/          # NestJS backend API
+├── toolkit/         # Auto-generated API client SDK
+├── templates/       # Project templates
+├── scripts/         # Build and deployment scripts
+└── docs/            # Documentation
+```
+
+## Development Workflow
+
+### Running Services
+
+```bash
+# Start both client and server in development mode
+pnpm run dev
+
+# Start only the server
+pnpm run dev:server
+
+# Start only the client
+pnpm run dev:client
+```
+
+### Building Packages
+
+```bash
+# Build all packages
+pnpm run build
+
+# Build specific packages
+pnpm run build:client
+pnpm run build:server
+pnpm run build:toolkit
+```
+
+### Testing
+
+```bash
+# Run all tests
+pnpm test
+
+# Run tests for specific package
+pnpm test --dir client
+pnpm test --dir server
+```
+
+## Code Style
+
+- Follow the existing code style in the project
+- Use TypeScript for type safety
+- Write clear, concise commit messages
+- Update documentation as needed
+
+## Pull Request Process
+
+1. Ensure your changes are well-tested
+2. Update the README.md if you've changed functionality
+3. Create a pull request with a clear title and description
+4. Link any related issues in your pull request description
+5. Be responsive to feedback during the review process
+
+## Reporting Issues
+
+If you find a bug or have a feature request, please [create an issue](https://github.com/fecommunity/reactpress/issues/new) on GitHub. Include as much detail as possible to help us understand and reproduce the problem.
+
+## Publishing Packages
+
+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
+
+## License
+
+By contributing to ReactPress, you agree that your contributions will be licensed under the MIT License.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+ 
+Copyright (c) [2024] [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.

package/README.md

@@ -0,0 +1,195 @@
+<div align="center">
+  <a href="https://gaoredu.com" title="ReactPress">
+    <img height="180" src="./public/logo.png" alt="ReactPress Logo">
+  </a>
+
+  <h1>ReactPress 2.0</h1>
+
+  <p align="center">
+    <em>Modern Full-Stack Publishing Platform Built with React, Next.js, and NestJS</em>
+  </p>
+
+  [![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
+```
+
+#### 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
+
+| 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 |
+
+### 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
+```
+
+## 🤝 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.
+
+## ❤️ Acknowledgments
+
+ReactPress is inspired by and built upon the work of many amazing open-source projects:
+
+- [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.
+
+## 📈 Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=fecommunity/reactpress&type=Date)](https://star-history.com/#fecommunity/reactpress&Date)

package/client/bin/reactpress-client.js

@@ -0,0 +1,190 @@
+#!/usr/bin/env node
+
+/**
+ * ReactPress Client CLI Entry Point
+ * This script allows starting the ReactPress client via npx
+ * Supports both regular and PM2 startup modes
+ */
+
+const path = require('path');
+const fs = require('fs');
+const { spawn, spawnSync } = require('child_process');
+
+// Capture the original working directory where npx was executed
+// BUT prioritize the REACTPRESS_ORIGINAL_CWD environment variable if it exists
+// This ensures consistency when running via pnpm dev from root directory
+const originalCwd = process.env.REACTPRESS_ORIGINAL_CWD || process.cwd();
+
+// Get command line arguments
+const args = process.argv.slice(2);
+const usePM2 = args.includes('--pm2');
+const showHelp = args.includes('--help') || args.includes('-h');
+
+// Show help if requested
+if (showHelp) {
+  console.log(`
+ReactPress Client - Next.js-based frontend for ReactPress CMS
+
+Usage:
+  npx @fecommunity/reactpress-client [options]
+
+Options:
+  --pm2        Start client with PM2 process manager
+  --help, -h   Show this help message
+
+Examples:
+  npx @fecommunity/reactpress-client          # Start client normally
+  npx @fecommunity/reactpress-client --pm2    # Start client with PM2
+  npx @fecommunity/reactpress-client --help   # Show this help message
+  `);
+  process.exit(0);
+}
+
+// Get the directory where this script is located
+const binDir = __dirname;
+const clientDir = path.join(binDir, '..');
+const nextDir = path.join(clientDir, '.next');
+
+// Function to check if PM2 is installed
+function isPM2Installed() {
+  try {
+    require.resolve('pm2');
+    return true;
+  } catch (e) {
+    // Check if PM2 is installed globally
+    try {
+      spawnSync('pm2', ['--version'], { stdio: 'ignore' });
+      return true;
+    } catch (e) {
+      return false;
+    }
+  }
+}
+
+// Function to install PM2
+function installPM2() {
+  console.log('[ReactPress Client] Installing PM2...');
+  const installResult = spawnSync('npm', ['install', 'pm2', '--no-save'], {
+    stdio: 'inherit',
+    cwd: clientDir
+  });
+  
+  if (installResult.status !== 0) {
+    console.error('[ReactPress Client] Failed to install PM2');
+    return false;
+  }
+  
+  return true;
+}
+
+// Function to start with PM2
+function startWithPM2() {
+  // Check if PM2 is installed
+  if (!isPM2Installed()) {
+    // Try to install PM2
+    if (!installPM2()) {
+      console.error('[ReactPress Client] Cannot start with PM2');
+      process.exit(1);
+    }
+  }
+  
+  // Check if the client is built
+  if (!fs.existsSync(nextDir)) {
+    console.log('[ReactPress Client] Client not built yet. Building...');
+    
+    // Try to build the client
+    const buildResult = spawnSync('npm', ['run', 'build'], {
+      stdio: 'inherit',
+      cwd: clientDir
+    });
+    
+    if (buildResult.status !== 0) {
+      console.error('[ReactPress Client] Failed to build client');
+      process.exit(1);
+    }
+  }
+  
+  console.log('[ReactPress Client] Starting with PM2...');
+  
+  // Use PM2 to start the Next.js production server
+  let pm2Command = 'pm2';
+  try {
+    // Try to resolve PM2 path
+    pm2Command = path.join(clientDir, 'node_modules', '.bin', 'pm2');
+    if (!fs.existsSync(pm2Command)) {
+      pm2Command = 'pm2';
+    }
+  } catch (e) {
+    pm2Command = 'pm2';
+  }
+  
+  // Start with PM2 using direct command
+  const pm2 = spawn(pm2Command, ['start', 'npm', '--name', 'reactpress-client', '--', 'run', 'start'], {
+    stdio: 'inherit',
+    cwd: clientDir
+  });
+  
+  pm2.on('close', (code) => {
+    console.log(`[ReactPress Client] PM2 process exited with code ${code}`);
+    process.exit(code);
+  });
+  
+  pm2.on('error', (error) => {
+    console.error('[ReactPress Client] Failed to start with PM2:', error);
+    process.exit(1);
+  });
+}
+
+// Function to start with regular Node.js (npm start)
+function startWithNode() {
+  // Check if the app is built
+  if (!fs.existsSync(nextDir)) {
+    console.log('[ReactPress Client] Client not built yet. Building...');
+    
+    // Try to build the client
+    const buildResult = spawnSync('npm', ['run', 'build'], {
+      stdio: 'inherit',
+      cwd: clientDir
+    });
+    
+    if (buildResult.status !== 0) {
+      console.error('[ReactPress Client] Failed to build client');
+      process.exit(1);
+    }
+  }
+
+  // ONLY set the environment variable if it's not already set
+  // This preserves the value set by set-env.js when running pnpm dev from root
+  if (!process.env.REACTPRESS_ORIGINAL_CWD) {
+    process.env.REACTPRESS_ORIGINAL_CWD = originalCwd;
+  } else {
+    console.log(`[ReactPress Client] Using existing REACTPRESS_ORIGINAL_CWD: ${process.env.REACTPRESS_ORIGINAL_CWD}`);
+  }
+
+  // Change to the client directory
+  process.chdir(clientDir);
+
+  // Start with npm start
+  console.log('[ReactPress Client] Starting with npm start...');
+  const npmStart = spawn('npm', ['start'], {
+    stdio: 'inherit',
+    cwd: clientDir
+  });
+
+  npmStart.on('close', (code) => {
+    console.log(`[ReactPress Client] npm start process exited with code ${code}`);
+    process.exit(code);
+  });
+
+  npmStart.on('error', (error) => {
+    console.error('[ReactPress Client] Failed to start with npm start:', error);
+    process.exit(1);
+  });
+}
+
+// Main execution
+if (usePM2) {
+  startWithPM2();
+} else {
+  startWithNode();
+}

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "@fecommunity/reactpress",
+  "author": "fecommunity",
+  "version": "2.0.0-beta-4-beta.1",
+  "description": "ReactPress - A full-stack CMS built with React, Next.js, and NestJS",
+  "keywords": [
+    "reactpress",
+    "cms",
+    "blog",
+    "react",
+    "nextjs",
+    "nestjs",
+    "typescript"
+  ],
+  "bin": {
+    "reactpress": "./scripts/reactpress-cli.js",
+    "reactpress-server": "./server/bin/reactpress-server.js",
+    "reactpress-client": "./client/bin/reactpress-client.js"
+  },
+  "files": [
+    "bin/**/*",
+    "scripts/**/*",
+    "client/bin/**/*",
+    "server/bin/**/*",
+    "CONTRIBUTING.md"
+  ],
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^9.4.1",
+    "concurrently": "^7.0.0",
+    "conventional-changelog-cli": "^3.0.0",
+    "cross-env": "^7.0.3",
+    "express": "^5.1.0",
+    "fs-extra": "^10.0.0",
+    "inquirer": "^8.2.4",
+    "mysql2": "^3.12.0",
+    "open": "^8.2.1",
+    "rimraf": "^3.0.2"
+  },
+  "engines": {
+    "node": ">=16.5.0"
+  },
+  "devDependencies": {
+    "husky": "^7.0.4",
+    "lint-staged": "^12.4.1",
+    "prettier": "^2.3.2",
+    "typescript": "~4.1.6"
+  },
+  "lint-staged": {
+    "*.{ts,tsx,js,jsx,.css,.scss}": "prettier --write",
+    "./client/**/*.{ts,tsx,js,jsx}": [
+      "eslint --fix"
+    ],
+    "./server/src/**/*.{ts,js}": [
+      "eslint --fix"
+    ],
+    "./config/**/*.{ts,tsx,js,jsx}": [
+      "eslint --fix"
+    ]
+  },
+  "scripts": {
+    "clean": "pnpm clean:node_modules && pnpm clean:dist",
+    "clean:node_modules": "npx rimraf ./node_modules ./**/node_modules",
+    "clean:dist": "npx rimraf ./dist ./**/dist",
+    "dev": "node ./scripts/reactpress-dev.js",
+    "dev:server": "pnpm run --dir ./server dev",
+    "dev:client": "pnpm run --dir ./client dev",
+    "dev:docs": "pnpm run --dir ./docs dev",
+    "build": "pnpm build:toolkit && pnpm build:server && pnpm build:client",
+    "build:packages": "node scripts/reactpress-cli.js --build",
+    "build:toolkit": "pnpm run --dir ./toolkit build",
+    "build:server": "pnpm run --dir ./server build",
+    "build:client": "pnpm run --dir ./client build",
+    "build:docs": "pnpm run --dir ./docs build",
+    "deploy:docs": "pnpm run --dir ./docs deploy:surge",
+    "deploy": "sh scripts/deploy.sh",
+    "start": "concurrently 'pnpm:start:*'",
+    "start:server": "pnpm run --dir ./server start",
+    "start:client": "pnpm run --dir ./client start",
+    "pm2": "pnpm run pm2:server && pnpm run pm2:client",
+    "pm2:server": "pnpm run --dir ./server pm2",
+    "pm2:client": "pnpm run --dir ./client pm2",
+    "lint": "concurrently 'pnpm:lint:*'",
+    "lint:client": "eslint --fix './client/**/*.{ts,tsx,js,jsx}'",
+    "lint:server": "eslint --fix './server/./**/*.{ts,js}'",
+    "format": "concurrently 'pnpm:format:*'",
+    "format:js": "prettier --write --parser typescript './**/*.{ts,tsx,js,jsx}'",
+    "precommit": "lint-staged",
+    "changelog": "conventional-changelog -p angular -i CHANGELOG.md -s  -r 0",
+    "release": "node scripts/reactpress-publish.js --publish"
+  }
+}