| Understand Radix sub-theme folder structure |
Radix Sub-Theme Architecture |
You're setting up a new Radix sub-theme You need to understand how Radix organizes files and loads Bootstrap You're mapping design system files to Radix file structure |
| Map design tokens to Bootstrap variables in Radix |
Design Tokens Configuration |
You've identified design tokens using the Design System Recognition Guide You've mapped tokens to Bootstrap variables using the Bootstrap Mapping Guide You need to know WHERE to put variable overrides in Radix |
| Create atom SDC components |
Atoms SDC Components |
You've identified atoms using the Design System Recognition Guide You need to decide when to create an atom SDC vs use Bootstrap classes You're creating foundational UI components |
| Master SDC component best practices |
SDC Component Best Practices |
You're deciding component granularity (too small vs too large) You need guidance on props vs slots architecture You're questioning whether a Bootstrap class is sufficient vs creating an SDC You want senior themer guidance on component… |
| Decide when to override vs extend Radix components |
Radix Sub-Theme Best Practices |
You're setting up a new Radix sub-theme You need to understand override strategy (when to override vs extend vs create) You're managing SCSS variables and compilation You want guidance on starterkit usage and library management |
| Configure build tools (Laravel Mix, PurgeCSS) |
Build Tools and Compilation |
You're setting up build tools for a new Radix sub-theme You need to configure Laravel Mix for SCSS/JS compilation You want to optimize production builds with PurgeCSS You're setting up live reload with BrowserSync |
| Use Radix CLI for component creation |
Radix CLI Integration |
You're creating new SDC components using Radix CLI You want to import existing Radix components into your sub-theme You need consistent component structure and Bootstrap integration |
| Compose atoms into molecule SDCs |
Molecules SDC Components |
You've identified molecules using the Design System Recognition Guide You need to compose multiple atoms into a reusable molecule You're implementing composite patterns like search bars, card content, form fields |
| Build organism SDCs with Layout Builder |
Organisms SDC Layout Builder |
You've identified organisms using the Design System Recognition Guide You're building complex sections like navbars, heroes, card grids You need to integrate organisms with Layout Builder |
| Override page templates in Radix |
Templates Drupal Theme Layer |
You're implementing page-level layouts (templates) You need to override Drupal's default page structure You're composing organisms into complete pages |
| Master Layout Builder patterns and decisions |
Layout Builder Best Practices |
You're deciding between Layout Builder, Paragraphs, or page templates You need guidance on when Layout Builder makes sense vs traditional theming You're implementing Layout Builder with SDC components You want to balance editorial… |
| Optimize theme performance (caching, assets, images) |
Performance Best Practices |
You're optimizing theme performance You need guidance on caching strategies You're implementing responsive images and modern formats You want to optimize asset loading |
| Write SDC YAML schema, props, and slots |
SDC Component Development |
You're creating new SDC components from scratch You need to define component props, slots, and schemas You're adding JavaScript to components |
| Master Twig and preprocess patterns |
Twig and Preprocess Best Practices |
You're deciding whether logic belongs in Twig or preprocess function You need guidance on Twig template inheritance (extend vs include vs embed) You're working with the Drupal attributes object You want performance best practices for Twig… |
| Catalog and reuse existing Radix components |
Radix Component Reuse Strategy |
You're evaluating whether to reuse, override, or create components You need a catalog of existing Radix SDC components You want to extend Radix components in your sub-theme |
| Troubleshoot SDC component issues |
Troubleshooting SDC Components |
Your SDC component isn't being discovered by Drupal Bootstrap classes aren't being applied correctly in your component You need to debug component registration or rendering issues You've replaced/overridden a Radix component and it's not… |