@e0ipso/ddev-worktree

🌿 DDEV Worktree

Supercharge your Drupal development workflow with automated Git worktrees and DDEV environments

Transform your feature development process from manual setup hell to one-command automation. Create isolated development environments in seconds, not minutes.

🚀 What is DDEV Worktree?

DDEV Worktree automates Git worktree creation with DDEV environments for Drupal development. Replace manual 5-minute setups with 30-second automation:

# Create a fully configured environment in one command
./ddev-worktree create 123 user-auth --clone-db

⚡ Quick Start

Installation (Recommended)

npm install -g @e0ipso/ddev-worktree

Alternative Installation Methods

# Manual installation for development
git clone https://github.com/e0ipso/ddev-worktree.git
cd ddev-worktree && chmod +x ddev-worktree

Create Your First Worktree

ddev-worktree create 123 my-feature --clone-db
cd ../drupal-worktrees/wt-123-my-feature
# Environment ready with DDEV running and dependencies installed

Prerequisites

• Node.js 16+ (for NPM installation)
• Git, DDEV, jq

📋 Core Features

• Git Worktree Management - Create, list, and remove worktrees with GitHub integration
• DDEV Automation - Automatic environment setup with smart port allocation
• Hook System - Customize workflows with lifecycle hooks and overrides
• Database Cloning - Clone databases from main environment (uses DDEV snapshots)

See Command Reference and Hook System for details.

🧪 Testing

Run the comprehensive E2E test suite that validates real DDEV environments:

./setup-bats.sh              # Install test dependencies (one-time setup)
./run-bats-tests.sh           # Run all E2E tests
./run-bats-tests.sh --verbose # Run with detailed output

📚 Documentation

• Installation Guide - Setup instructions
• Quick Start - Getting started
• Command Reference - All commands
• Hook System - Automation and customization
• Hook Examples - Comprehensive integration examples
• Troubleshooting - Common issues

🤝 Contributing

Contributions may be welcome. See the Contributing Guide for details.

📄 License

This software is distributed under a Proprietary License with Revocation Rights. Free to use with conditions - see LICENSE file for details.