Deploy ForgeDeployForge
Deploy ForgeDeployForge
Back to Home

Introduction

Deploy Forge automates WordPress theme deployment from GitHub repositories. It consists of a web platform that coordinates deployments and a WordPress plugin that handles the actual file updates. 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
  • Local Backups - Optionally back up your theme before each deployment
  • 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. Deploy Forge coordinates the deployment:
    • Creates a deployment record and notifies your WordPress site
    • For GitHub Actions: triggers your workflow, then provides the build artifact download URL
    • For Direct Clone: provides temporary repository access credentials
  4. WordPress Plugin handles the deployment:
    • Downloads the artifact or clones the repository
    • Backs up your current theme (if enabled)
    • 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 and uploads an artifact. The WordPress plugin downloads and deploys the result.

Direct Clone (No Build): For simple themes with plain CSS/JS. Your WordPress plugin clones the repository directly using temporary credentials from Deploy Forge—no build step needed.

Requirements

  • WordPress 5.8+ (6.0+ recommended)
  • PHP 7.4+ (8.1+ recommended)
  • GitHub repository with your theme code