Install
Works with Drupal: ^11.5 || ^12Using Composer to manage Drupal site dependencies
Alternative installation files
Release notes
Use this release, not 1.0.0-alpha1. It has the same code. While this project was a submodule of the Design System API, packages.drupal.org published each Design System API release from 1.0.0-alpha1 to 1.0.0-alpha7 as a metapackage named drupal/design_system_api_chrome, which installs no code of its own. This release is numbered past them, so composer require drupal/design_system_api_chrome:^1.0@alpha installs the project.
The first usable release: core's admin chrome on the Design System API's contract. Navigation (sidebar and top bar), contextual links, and the Toolbar with Admin Toolbar take the chrome context's colour, type, spacing, radius, shadow and focus. Up to Design System API 1.0.0-alpha7 this was the module's design_system_api_chrome submodule.
Status: experimental. It follows the Design System API's contract, which will still change.
What it does
- Marks the roots of core's chrome as the chrome context's regions, so they take the chrome's values on any page.
- Where a chrome library is attached, removes core's skin CSS for them and draws them on contract tokens. Forced colours are handled.
- With Display preferences installed, the color mode and contrast switch sits in the top bar.
Moving from the Design System API's submodule
- The machine name is the same. Add this project with Composer before updating the Design System API to 1.0.0-alpha8, and the site keeps its configuration.
Requirements
Drupal ^11.5 || ^12, PHP 8.3 or later, and the Design System API 1.0.0-alpha8 or later.
