DDEV Drupal Suite add-on

This DDEV add-on streamlines the setup of development environments for working on Drupal contributed modules. It’s specifically designed to make it easy to contribute to two or more contrib modules simultaneously—especially useful when one module depends on another. With just a few commands, you can spin up any version of Drupal core, clone multiple contrib modules into the environment, and start developing or testing changes across them in parallel.

Features

• Spin up any version of Drupal core into a DDEV environment.
• Clone any combination of contrib modules.
• Download and install Drupal recipes.
• Download any other Drupal contrib module.
• Run PHPStan, PHPUnit, and PHPCS on your contrib modules.
• No need to add DDEV specific artifacts to your contrib modules.

Install

Let's say you need to work on the ai module for Drupal 11.2.2, you can run the following commands:

mkdir ai-dev && cd ai-dev
ddev config --project-type=drupal11 --docroot=web --php-version=8.3 --corepack-enable
ddev add-on get lussoluca/ddev-drupal-suite
ddev drupal-init 11.2.2
ddev drupal-get-module ai 1.2.x

This will set up a DDEV environment with Drupal 11.2.2 and clone the 1.2.x branch of the ai module into the web/modules/contrib/ai directory. You can then work in the web/modules/contrib/ai directory as usual, by adding your changes, committing them, and pushing them to your remote repository.

Work on more modules

If later you also need to work on the ai_agents module, you can add its source code to your DDEV environment by running:

ddev drupal-get-module ai_agents 1.2.x

Require other contrib modules

If you just need a contrib module or theme to be present, but you don't need to work on it, you can use standard composer commands to add it to your DDEV environment:

ddev composer require drupal/ai_provider_openai:^1.1

Download Drupal recipes

You can also download Drupal recipes to your DDEV environment. For example, to download the drupal/ai_dev_recipe recipe, you can run:

ddev drupal-get-recipe ai_dev_recipe

This will download the recipe and install it in your DDEV environment, making it available for use.

Run PHPStan, PHPUnit, and PHPCS

You can run PHPStan, PHPUnit, and PHPCS on your contrib modules by using the following commands:

ddev phpstan ai
ddev phpunit ai
ddev phpcs ai

These commands will analyze the ai module for bugs, run unit tests, and check coding standards, respectively. You can replace ai with the name of any other module you have cloned into your DDEV environment.