# Design system Read [DESIGN-GUIDELINES.md](DESIGN-GUIDELINES.md) before changing the UI. It covers tokens, typography, components, motion and responsive behavior. The frontend owns its CSS tokens in `frontend/src/index.css`, motion presets in `frontend/src/lib/motion.ts`, and shadcn configuration in `frontend/components.json`. User-defined dashboards have their own appearance and motion settings. See [Dashboards and devices](docs/interface/dashboards.md) for that contract.