DDEV Kanopi WordPress Add-on¶
A comprehensive DDEV add-on that provides Kanopi's battle-tested workflow for WordPress development. This add-on includes complete tooling for modern WordPress development with multi-provider hosting support.
Features¶
This add-on provides:
- 26 Custom Commands: Complete WordPress development workflow with namespaced commands
- Multi-Provider Hosting: Support for Pantheon, WPEngine, and Kinsta hosting platforms
- Block Creation Tooling: Command to generate custom WordPress blocks with proper scaffolding
- Asset Compilation: Webpack-based build system using
@wordpress/scripts - Testing Framework: Cypress E2E testing with user management
- Database Management: Smart refresh system with 12-hour backup detection
- Theme Development: Node.js, NPM, and build tools with file watching
- Security & Performance: Nginx configuration with headers and optimization
- Services Integration: PHPMyAdmin, Redis, and Solr via official DDEV add-ons
- Environment Configuration: Clean configuration system using environment variables
Quick Start¶
Get started with the add-on in just a few steps:
# Install the add-on
ddev add-on get kanopi/ddev-kanopi-wp
# Configure your hosting provider and project settings
ddev project-configure
# Initialize your development environment
ddev project-init
Documentation Structure¶
- Installation: Complete installation guide for new and existing projects
- Configuration: Set up hosting providers and project settings
- Commands: Complete reference of all 26+ available commands
- Hosting Providers: Platform-specific setup guides
- Theme Development: Asset compilation and block creation
- Troubleshooting: Common issues and solutions
Key Commands¶
| Command | Description |
|---|---|
ddev project-init |
Complete development environment setup |
ddev project-configure |
Interactive configuration wizard |
ddev db-refresh [env] |
Smart database refresh with backup detection |
ddev theme-watch |
Start theme development with file watching |
ddev theme-create-block <name> |
Create new WordPress blocks |
ddev wp-open [admin] |
Open site or admin in browser |
Multi-Provider Support¶
The add-on supports all major WordPress hosting platforms:
- Pantheon: Full Terminus integration with backup management
- WPEngine: SSH-based operations with specific key handling
- Kinsta: Direct SSH access with custom configurations
Originally Contributed by Kanopi Studios