π¨ Frontend & Design Playbook Alignment¶
This document ensures that frontend development faithfully implements the guidelines defined in the LOGYCA Design Playbook.
Design and development are not separate disciplines. They are parts of the same system.
π Key Principle¶
Everything that is designed must be implementable
Everything that is implemented must be designed
π Design β Code Mapping¶
| Design Playbook | Frontend Implementation |
|---|---|
| Color system | Global SCSS variables |
| Typography | Globally loaded fonts |
| UI components | Reusable components |
| States | Controlled logic and classes |
| Grid system | Consistent layouts |
π¨ Colors¶
- Playbook-defined colors are the single source of truth
- No new colors are created in code
- No manual color adjustments
π All colors must come from SCSS variables.
π€ Typography¶
- Official fonts must be loaded globally
font-familymust not be defined per component- Font weights and hierarchy must follow the Playbook
π§© UI Components¶
Every designed component must: - Have a clear purpose - Define all states - Be reusable
π Components created for a single screen are not allowed.
π Visual States¶
All components must support:
- Default
- Hover
- Focus
- Disabled
- Error
- Loading (if applicable)
β Validation Rule¶
Any implementation that: - Deviates from the Playbook - Introduces undefined variations - Breaks visual consistency
Must be corrected before approval.