Skip to main content
drupalreleases

Use direct release data with your AI assistant.

Learn more

Emulsify Tools

Security covered Under active development 1,326 sites

Part of the Emulsify ecosystem · 4 projects

This module provides tools for Emulsify themes, enabling component-driven Twig templates with features like BEM class generation, attribute merging, and theme-defined Twig namespaces. It also offers Drush commands for generating child themes and managing favicon deployments across environments.

Tools for Emulsify themes and component-driven Twig templates

Emulsify Tools is a companion module for Emulsify. It provides the Drupal-side utilities that help Emulsify-based themes work cleanly with component-oriented Twig templates, reusable namespaces, Drush commands, and deployment-friendly favicon workflows.

Use Emulsify Tools when your Drupal project uses Emulsify and you want a supported way to generate child themes, keep template class naming consistent, register component namespaces from your theme, and manage generated favicon packages across environments.

What Emulsify Tools provides

  • Twig helper functions: use bem() to generate BEM-style class names and add_attributes() to merge Drupal template attributes into reusable component templates.
  • Theme-defined Twig namespaces: register component paths in a theme’s .info.yml file so templates can reference components with namespace syntax such as @atoms/button/button.twig.
  • Twig switch/case support: use switch, case, default, and endswitch tags for clearer conditional logic in Twig templates.
  • Child theme generation: generate Emulsify child themes with Drush using drush emulsify_tools:bake my_theme.
  • Favicon deployment commands: generate, inspect, reset, and repair generated favicon package state for Emulsify-based themes.
  • Emulsify 7 upgrade support: backfill favicon configuration and repair older generated child themes so they can participate in the Emulsify 7 favicon workflow.

Current stable release: 2.x

The 2.x release line is intended to pair with Emulsify 7.x. It targets Drupal ^11.3 || ^12 and supports Drush 13+ command workflows.

The Twig helpers, switch/case extension, and namespace support are useful for Emulsify-based Drupal themes in general. The favicon migration, generated favicon package, and admin-theme favicon features are designed for the Emulsify 7.x companion theme APIs.

If you are maintaining an Emulsify 6.x project, use the 1.x release line of Emulsify Tools. Use 2.x for new Emulsify 7.x work and Drupal 11.3+/12-ready projects.

Favicon deployment workflow

Emulsify 7.x stores portable favicon source data and generated package metadata in theme settings. Emulsify Tools provides the Drush commands that make that workflow reliable after deployments and configuration imports.

  • drush emulsify_tools:favicon-generate my_theme generates or refreshes a favicon package from saved Emulsify theme settings.
  • drush emulsify_tools:favicon-status my_theme reports package state, dependency availability, and portable SVG source status.
  • drush emulsify_tools:favicon-reset my_theme removes generated package state and restores default favicon behavior.
  • drush emulsify_tools:repair-favicon-config my_theme backfills missing favicon config and schema entries in older generated child themes.

Installation

Install Emulsify Tools with Composer:

composer require 'drupal/emulsify_tools:^2.0'

Emulsify Tools is typically installed alongside Emulsify:

composer require 'drupal/emulsify:^7.0'

composer require 'drupal/emulsify_tools:^2.0'

Related projects

  • Emulsify: the Drupal parent/base theme for Emulsify-based Drupal projects.
  • Emulsify Core: frontend build tooling, Storybook integration, Sass, JavaScript, React, and Twig support.
  • Emulsify documentation: project guides, release information, and supporting documentation.

Documentation and development

All issue tracking and contribution work happens on GitHub.

Drupal 11 · not 10 PHP ^8.3

Ask your assistant about Emulsify Tools

Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works

Depends on

Dependencies of the latest stable release

No dependencies recorded for this project.

Required by

1 tracked project depends on this one

Activity

Tracked releases
11
Tracked since
Mar 2024
Latest release
2 months ago
Releases (12 mo)
9 ▲ from 0
Maintenance
Active

Release Timeline

Releases

Version Type Core PHP Release date
2.2.2 Stable 11 PHP ^8.3 Sep 11, 2026
1.1.1 Stable 10–11 Aug 11, 2026
2.2.1 Stable 11 Aug 11, 2026
2.2.0 Stable 11 Aug 1, 2026
2.1.2 Stable 11 Jul 20, 2026
2.1.1 Stable 11 Jul 3, 2026
2.1.0 Stable 11 Jun 15, 2026
2.0.0 Stable 11 Jun 4, 2026
1.1.0 Stable 10–11 May 21, 2026
1.0.1 Stable 10–11 Jun 7, 2024