---
type: Decision
title: Design language
description: UI/UX conventions decided for this app, applied consistently.
tags: [design, ui]
---
# Design Language

High-level UI/UX decisions for this app. Use component inspection and the codebase for implementation details — record only things here that aren't obvious from reading the code, and only once a decision has been made and should be applied consistently.

<!-- e.g.
  - Drawers or modals? (which component, when each is used)
  - Toast notifications or inline feedback? (library, placement, which events trigger each)
  - Sidebar navigation: structure, depth levels, active state, how sections collapse
  - Loading states: skeletons, spinners, or shimmer? where each is used
  - Empty states: pattern and shared component if one exists
  - Confirmation pattern: modal, inline expand, or separate page?
  - Button hierarchy: primary / secondary / destructive variants
  - Typography: font families and when each is used, label conventions
  - Color token conventions: semantic names for status, surfaces, text
  - Form layout: label style, field spacing, error placement
  - Elevation / layering: how cards, panels, and overlays stack
-->