drupal/config_split_recipe

Drupal recipe package for an opinionated dev, staging, and prod Config Split baseline.

dev-master 2026-06-16 19:35 UTC

Requires

• drupal/config_split: ^2.0
• drupal/core: ^10.3 || ^11

GPL-2.0-or-later

README

What This Recipe Does

This recipe installs Config Split and creates three disabled environment split entities for development, staging, and production.

This is an opinionated baseline, not a fully generic split toolkit.

Package

• Composer package: drupal/config_split_recipe
• Recipe manifest: recipe.yml

Included Behavior

• Creates split entities: dev, staging, prod
• Leaves split status disabled by default
• Uses folder-based split storage paths

Requirements

• Drupal 10.3 or 11
• Config Split module

Install

composer require drupal/config_split_recipe

Apply

drush recipe config_split_setup

Post-Apply Steps

1. Configure settings.php logic to activate the right split per environment.
2. Import config as needed for your deployment flow.
3. Run cache rebuild if required.

Known Limitations

• Split activation is always environment-specific and cannot be fully automated by the recipe alone.
• The shipped split content reflects this project baseline and may need adjustments in other environments.

Maintenance

• The split payload under configs/split is read at runtime by Config Split.
• The recipe is safe to re-apply because strict is set to false.