Introduction

Deploy Forge is a WordPress plugin that automates theme deployment from GitHub repositories. Push code to GitHub, and it automatically deploys to your WordPress site—no FTP, no manual uploads, no hassle.

Key Features

• Automatic Deployments - Deploy on every push via GitHub webhooks
• GitHub Actions Integration - Build your theme with npm, webpack, or any build process
• Direct Clone Option - Skip the build step for simple themes without build tools
• Automatic Backups - Every deployment creates a backup you can restore
• One-Click Rollback - Instantly revert to any previous deployment
• Manual Approval Mode - Optionally require approval before deployments go live
• Deployment History - Track all deployments with logs and status
• Secure - HMAC webhook validation and encrypted credential storage

How It Works

+-------------+      +-------------+      +-----------------+
 |  Git Push   | ---> |   GitHub    | ---> |    WordPress    |
 |             |      |   Webhook   |      |     Plugin      |
 +-------------+      +-------------+      +--------+--------+
                                                   |
                     +-----------------------------+
                     |
                     v
          +---------------------+
          |  Trigger Workflow   |
          +----------+----------+
                     |
                     v
          +---------------------+
          |  Wait for Build     |
          +----------+----------+
                     |
                     v
          +---------------------+
          |  Download Artifact  |
          +----------+----------+
                     |
                     v
          +---------------------+
          |  Backup Theme       |
          +----------+----------+
                     |
                     v
          +---------------------+
          |  Deploy New Files   |
          +---------------------+

Two Deployment Methods

GitHub Actions (Build + Deploy): For themes that need compilation—webpack, npm, SCSS, TypeScript. Your workflow builds the theme, Deploy Forge downloads and deploys the result.

Direct Clone (No Build): For simple themes with plain CSS/JS. Deploy Forge downloads your repository directly, no build step needed. Deployments complete in seconds.

Requirements

• WordPress 5.8+ (6.0+ recommended)
• PHP 7.4+ (8.1+ recommended)
• HTTPS enabled (required for webhooks)
• GitHub repository with your theme code