A CLI tool for testing WordPress plugins and themes using WordPress Playground.

# Install as dev dependency (recommended)
npm install --save-dev @wp-tester/cli

# Setup and run tests
wp-tester setup
wp-tester test

Or run directly without installing:

npx @wp-tester/cli@latest setup

See the Installation Guide for details on when to use each approach.

• Matrix Testing - Test across multiple PHP and WordPress versions
• Multiple Test Types - Smoke tests, PHPUnit tests, and custom tests
• WordPress Playground - Isolated environments with no local setup
• Flexible Configuration - JSON-based with IDE autocomplete support
• GitHub Actions Integration - Auto-generate CI workflows with wp-tester config ci

• Getting Started - Installation, setup, and basic usage
• Configuration - Complete configuration reference
• Development - Contributing and development setup

{
  "$schema": "https://raw.githubusercontent.com/bgrgicak/wp-tester/trunk/packages/config/src/schema.json",
  "environments": [
    {
      "name": "PHP 8.2 + WP 6.7",
      "blueprint": {
        "preferredVersions": {
          "php": "8.2",
          "wp": "6.7"
        }
      }
    }
  ],
  "tests": {
    "plugin": "my-plugin",
    "wp": true
  }
}

See Configuration Documentation for more examples.

GPL-2.0