SDC - Component library
This module streamlines the development and visual testing of Single-Directory Components (SDCs) directly from your theme. It allows you to easily preview and test individual components with sample data, and can also perform accessibility checks. This helps ensure a consistent design system and simplifies component development by allowing you to see them in isolation without needing to build full pages.
Introduction
SDC Component Library makes developing Drupal components more efficient by enabling easy rendering and visual testing of Single-Directory Components (SDCs) directly from the theme. Components with a .story.twig file can be previewed with dummy data.
Features
The SDC Component Library module provides the following functionality:
- Automatically reads and lists all SDCs from your theme.
- Allows rendering components with a .story.twig file using dummy data.
- Enables visual inspection and testing of components at /components.
- Integration with a WCAG checker for accessibility validation.
This module is perfect for developers who want to streamline their component development workflow, allowing them to see and test their components without setting up full content pages.
Use cases include:
- Rapid component development and testing.
- Ensuring consistent design system implementation.
- Accessibility checks directly within component previews.
Post-Installation
Once installed, the module reads all components from your theme folder that are set up as SDCs. You can access the component list at /components. No additional configuration is needed. However, to utilize the full functionality, ensure your components have a .story.twig file, which allows them to be rendered with sample data.
Additional Requirements
- Single Directory Components (SDC) module enabled.
This module requires the SDC module to be active and functional within your theme.
Similar Projects
Other component development modules in Drupal exist, such as UI Patterns or storybook. However, SDC Component Library is uniquely focused on leveraging Single-Directory Components and providing direct visual previews of each component without complex setup.
Depends on
Dependencies of the latest stable release
No dependencies recorded for this project.
Required by
Tracked projects that depend on this one
No tracked projects depend on this one yet.
Activity
Release Timeline
Releases
| Version | Type | Core | Notes | Release date | |
|---|---|---|---|---|---|
| 1.0.5 | Stable | 10–11 | Feb 26, 2026 | ||
| 1.0.4 | Stable | 10–11 | Feb 24, 2026 | ||
| 1.0.3 | Stable | 10–11 | Jan 9, 2026 | ||
| 1.0.2 | Stable | 10–11 | Jan 9, 2026 | ||
| 1.0.1 | Stable | 10–11 | Nov 10, 2025 | ||
| 1.0.x-dev | Dev | 10–11 | Oct 8, 2025 | ||
| 1.0.0 | Stable | 10–11 | Oct 8, 2025 | ||
| 1.0.0-beta6 | Pre-release | 10–11 | Replace hardcoded route permission | Feb 11, 2025 | |
| 1.0.0-beta5 | Pre-release | 10–11 | Nov 28, 2024 | ||
| 1.0.0-beta4 | Pre-release | 10–11 | Oct 29, 2024 | ||
| 1.0.0-beta3 | Pre-release | 10–11 | Oct 24, 2024 | ||
| 1.0.0-beta2 | Pre-release | 10–11 | Oct 11, 2024 | ||
| 1.0.0-beta1 | Pre-release | 10–11 | Oct 11, 2024 | ||
| 1.0.0-alpha4 | Pre-release | 10–11 | Oct 9, 2024 | ||
| 1.0.0-alpha3 | Pre-release | 10–11 | Oct 9, 2024 | ||
| 1.0.0-alpha2 | Pre-release | 10–11 | We have introduced the ComponentPluginManager to the module, significantly improving the way components are retrieved and managed. | Oct 7, 2024 | |
| 1.0.0-alpha1 | Pre-release | 10–11 | First release for the SDC - component library | Oct 7, 2024 |