Skip to content

README.md

Latest commit

 

History

History
123 lines (94 loc) · 3.59 KB

README.md

File metadata and controls

123 lines (94 loc) · 3.59 KB

WordPress Claude Code Wizard 🚀

Automated WordPress development and deployment pipeline for Digital Ocean. Develop locally with Docker, deploy to production with one command.

Features

  • Identical Stack to DO: Ubuntu 22.04, Apache 2.4.52, PHP 8.3, MySQL 8.0.42

  • Custom Theme: Ready-to-develop theme in wp-content/themes/my-custom-theme/

  • Custom Post Types Plugin: Portfolio and Testimonials CPTs

  • One-Click Deployment: Automated migration script to Digital Ocean

  • Environment-Aware Config: wp-config.php works on both local and production

  • Try SEO Grove: SEO Grove

  • Join my Skool to say thanks: My Skool

Quick Start

1. Setup Environment

# Clone the repository
git clone https://github.com/IncomeStreamSurfer/wordpress-claude-code-wizard.git
cd wordpress-claude-code-wizard

# Copy and configure .env
cp .env.example .env
# Edit .env and add your Digital Ocean API token

2. Local Development

# Start WordPress locally
docker-compose up -d

# Access at http://localhost
# phpMyAdmin at http://localhost:8080

3. Deploy to Digital Ocean

# One-time SSH setup
./setup_ssh_and_deploy.sh

# Create droplet and deploy
python3 create_droplet_with_ssh.py

# Wait 5-10 minutes for installation
# Then migrate your local WordPress
./migrate_now.sh

Development Workflow

Working on Your Custom Theme

  • Theme files: wp-content/themes/my-custom-theme/
  • Changes are reflected immediately (no restart needed)

Working on Custom Post Types

  • Plugin files: wp-content/plugins/custom-post-types/
  • After activation, you'll see Portfolio and Testimonials in the admin menu

Post-Deployment

After deployment:

  1. Your site is live at http://YOUR_DROPLET_IP
  2. Point your domain's A record to the droplet IP
  3. Set up SSL: 
    ssh -i ~/.ssh/wordpress_deploy root@YOUR_IP
certbot --apache

File Structure

.
├── docker-compose.yml              # Docker configuration
├── Dockerfile                      # Custom Apache/PHP image
├── wp-config.php                   # Environment-aware config
├── .htaccess                       # Apache rules
├── setup_ssh_and_deploy.sh         # SSH key setup
├── create_droplet_with_ssh.py      # Droplet creation
├── migrate_now.sh                  # Migration script
├── wp-content/
│   ├── themes/
│   │   └── my-custom-theme/        # Your custom theme
│   └── plugins/
│       └── custom-post-types/      # CPT plugin
└── .claude/                        # Claude's workflow memory

Database Access

Local Development:

  • Host: localhost:3306
  • Database: wordpress
  • User: wordpress
  • Password: wordpress_password

phpMyAdmin: http://localhost:8080

Requirements

  • Docker & Docker Compose
  • Python 3 with pip
  • Digital Ocean account with API token
  • 10-15 minutes for complete deployment

Security Notes

  • Change all default passwords before production
  • Update wp-config.php salts (done automatically during deployment)
  • Enable firewall on Digital Ocean: ufw allow 22,80,443/tcp && ufw enable
  • Keep WordPress, themes, and plugins updated

How It Works

  1. Docker provides identical environment to production
  2. SSH keys are automatically configured for passwordless access
  3. Cloud-init installs WordPress on the droplet
  4. Migration script transfers your themes, plugins, and content
  5. URL updates are handled automatically

From local development to live production in minutes!