DeployX

AI-powered CLI deployment platform for modern monorepo applications.

Deploy smarter with AI. DeployX automates the entire deployment process for pnpm monorepos, Next.js, Express, Node.js, and Docker apps to VPS servers — from code upload to SSL setup.

npm install -g deployx-ai-cli

Quick Start

# Initialize
deployx init

# Scan your monorepo
deployx scan

# Deploy with one command
deployx deploy

Features

• Monorepo Detection — Auto-detects pnpm workspace, Turborepo, Nx
• AI Deployment Planning — Analyzes project structure, decides build order & runtime
• One-Command Deploy — Uploads, installs, builds, configures nginx, enables SSL, starts services
• AI Self-Healing — Analyzes logs, detects issues, suggests/auto-fixes errors
• SSL Automation — Automatic HTTPS via Certbot + Nginx
• Health Diagnostics — Runs deployx doctor to check nginx, SSL, ports, PM2, CPU, memory

Supported Frameworks

| Framework | Supported | |------------|-----------| | Next.js | Yes | | Express.js | Yes | | Vite | Yes | | React | Yes | | Node.js | Yes | | NestJS | Planned | | Bun | Planned |

CLI Commands

deployx init       Initialize project (creates deployx.config.ts)
deployx scan       Detect apps, packages, and build order
deployx deploy     Deploy to production/staging
deployx logs       View remote PM2 logs
deployx rollback   Rollback to previous release
deployx ssl        Setup SSL certificates via Certbot
deployx doctor     Health check (nginx, SSL, ports, PM2, memory, CPU)
deployx ai         Interactive AI deployment assistant

Architecture

CLI
 ├── Scanner Engine    — pnpm/turborepo/nx detection
 ├── AI Engine         — OpenAI-powered planning & diagnostics
 ├── Deploy Engine     — Orchestrates full deployment flow
 ├── SSH Engine        — Remote command execution & file upload
 ├── PM2 Manager       — Ecosystem file generation & process management
 ├── Docker Engine     — Dockerfile & compose generation
 ├── SSL Manager       — Certbot integration
 └── Nginx Generator   — Reverse proxy configuration

Deployment Flow

Project Scan → AI Analysis → Server Connect → File Upload
    → Dependencies → Build → PM2/Docker Start → Health Check

Configuration

Create deployx.config.ts:

export default {
  server: {
    host: "1.1.1.1",
    user: "root",
    port: 22,
  },
  apps: [
    { name: "web", path: "apps/web", framework: "nextjs", port: 3000 },
    { name: "api", path: "apps/api", framework: "express", port: 8000 },
  ],
};

Requirements

• Node.js >= 18
• SSH access to your VPS server
• OpenAI API key (optional, for AI features)

Setting Up OpenAI API Key

DeployX uses AI for deployment planning and error diagnostics. To enable AI features:

# Option 1: Environment variable
export OPENAI_API_KEY=sk-your-key-here

# Option 2: .env file in your project root
echo "OPENAI_API_KEY=sk-your-key-here" >> .env

# Option 3: .env.example included with deployx init
deployx init
# Then edit .env file with your key

Get your key at platform.openai.com/api-keys.

DeployX works without an API key using fallback plans, but AI planning, error analysis, and the deployx ai chat command require it.

License

MIT