Skill

config-management

Drupal configuration management including config export/import, Config Split, environment-specific configuration, and config override patterns. Use when managing Drupal configuration, setting up Config Split, or handling environment-specific settings.

Install

npx claudepluginhub abderrahimghazali/drupal-boost

Tool Access

This skill is limited to using the following tools:

ReadWriteEditBashGrep

Preview

Configuration is stored in YAML files and tracked in the `config/sync` directory (set in `settings.php` via `$settings['config_sync_directory']`).

Supporting Assets

reference/config-split-patterns.mdreference/config-workflow.md

SKILL.md

Similar Skills

design-system

Generates design tokens/docs from CSS/Tailwind/styled-components codebases, audits visual consistency across 10 dimensions, detects AI slop in UI.

team-skills-platform

163.7k

ui-demo

Records polished WebM UI demo videos of web apps using Playwright with cursor overlay, natural pacing, and three-phase scripting. Activates for demo, walkthrough, screen recording, or tutorial requests.

team-skills-platform

163.7k

kotlin-patterns

Delivers idiomatic Kotlin patterns for null safety, immutability, sealed classes, coroutines, Flows, extensions, DSL builders, and Gradle DSL. Use when writing, reviewing, refactoring, or designing Kotlin code.

team-skills-platform

163.7k

Stats

Stars1

Forks0

Last CommitMar 22, 2026

Actions

View Source View Plugin View on GitHub View README

Drupal Configuration Management

Core Concepts

Configuration is stored in YAML files and tracked in the config/sync directory (set in settings.php via $settings['config_sync_directory']).

Essential Commands

# Export all config
drush config:export    # or drush cex
# Import all config
drush config:import    # or drush cim
# Check status (what's changed)
drush config:status    # or drush cst
# Export single config
drush config:get system.site
# Set single value
drush config:set system.site name "My Site"

Config Split (Multi-Environment)

Install: composer require drupal/config_split

Setup for dev/staging/prod

# config/sync/config_split.config_split.dev.yml
id: dev
label: Development
folder: ../config/splits/dev
status: true
weight: 0
module:
  devel: 0
  kint: 0
  webprofiler: 0
theme: {}
complete_list: []
partial_list: []

Activate per environment in settings.php

// settings.php
$config['config_split.config_split.dev']['status'] = FALSE;
$config['config_split.config_split.prod']['status'] = FALSE;

// settings.local.php (dev only)
$config['config_split.config_split.dev']['status'] = TRUE;

// settings.prod.php (prod only)
$config['config_split.config_split.prod']['status'] = TRUE;

Config Split Commands

drush config-split:export dev    # or drush csex dev
drush config-split:import dev    # or drush csim dev

Config Overrides in settings.php

Override any config at runtime (not exported):

// Disable caching in development
$config['system.performance']['css']['preprocess'] = FALSE;
$config['system.performance']['js']['preprocess'] = FALSE;

// Change site name per environment
$config['system.site']['name'] = 'My Site (Dev)';

Config Schema

Always define schema for custom config in config/schema/MODULE_NAME.schema.yml:

MODULE_NAME.settings:
  type: config_object
  label: 'Module settings'
  mapping:
    api_key:
      type: string
      label: 'API Key'
    max_items:
      type: integer
      label: 'Maximum items'
    enabled:
      type: boolean
      label: 'Enabled'

Workflow

Make config changes on your dev site
Export: drush cex
Commit the YAML files
On deploy: drush cim
For environment-specific config, use Config Split

Key Rules

Never edit config YAML files by hand unless you know what you're doing
Always export after making config changes in the UI
Always define config schema for custom module configuration
Use Config Split for environment-specific modules and settings
Use $config overrides in settings.php for secrets and environment values
Run drush cim as part of your deployment pipeline
Check drush cst before importing to see what will change