README

Follow the steps below to install the Pulse Recipe in your Drupal CMS project.

1. Extract the Recipe

Download the recipe ZIP file and extract it inside the recipes directory of your Drupal CMS project.

Example directory structure after extraction:

drupal-project/
 ├── recipes/
 │   └── pulse/
 │       ├── recipe.yml
 │       ├── composer.json
 │       └── themes/
 │           └── space_ds/

2. Configure Composer Path Repositories

From the root of your Drupal project, run the following commands:

composer config repositories.pulse '{"type":"path","url":"recipes/pulse","options":{"symlink":false}}'

composer config repositories.space-ds '{"type":"path","url":"recipes/pulse/themes/space_ds","options":{"symlink":true}}'

These commands tell Composer to install the recipe and theme from the local path instead of downloading them from Drupal.org.

3. Install the Recipe Packages

Run the following Composer commands:

composer require custom/pulse:1.0.0
composer require custom/space-ds:1.0@RC

This installs the Pulse recipe and the Space DS theme from the local recipe directory.

4. Rebuild Dependencies

Before installing Drupal, remove the existing Composer lock file and reinstall dependencies.

rm composer.lock
composer install

This ensures all dependencies from the recipe's composer.json are correctly installed.

5. Install Drupal Using the Recipe

Run the following command to install Drupal using the Pulse recipe:

ddev drush si recipes/pulse

This will install Drupal and automatically apply the configuration, modules, and components included in the recipe.

Notes

• The space_ds theme will be installed via a Composer path repository from the recipe directory.
• If Drupal is already installed, you must reinstall the site to apply the recipe.

Troubleshooting

If Composer installs packages from Drupal.org instead of the recipe folder, verify that:

• The repositories entries exist in the root composer.json.
• The recipe path recipes/pulse exists.
• The theme path recipes/pulse/themes/space_ds exists.
• Run composer clear-cache and retry if necessary.