@e0ipso/ddev-worktree
v1.4.1
Published
Automated Git worktree setup with DDEV for Drupal development
Downloads
94
Maintainers
Readme
🌿 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-worktreeAlternative Installation Methods
# Manual installation for development
git clone https://github.com/e0ipso/ddev-worktree.git
cd ddev-worktree && chmod +x ddev-worktreeCreate 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 installedPrerequisites
- 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.
