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

1. Git Push - You push code to your GitHub repository
2. GitHub Webhook - GitHub notifies Deploy Forge of the change
3. WordPress Plugin receives the webhook and starts the deployment:
   • Triggers your GitHub Actions workflow
   • Waits for the build to complete
   • Downloads the build artifact
   • Backs up your current theme
   • Deploys the 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