jobtrackingapp/docs/frontend/ui-system.md

UI system

MUI 7 components and the shared theme in job-tracker-ui/src/theme.ts define the visual foundation. Light and dark modes are user preferences; status colors communicate pipeline meaning and must not be used as the only signal. Forms, dialogs, loading states, errors, attachments, CV editing, job workspaces, and admin settings are implemented as feature components rather than a separate design-system package.

The UI supports responsive layouts for desktop and narrow screens, but route-specific overflow and keyboard/focus behavior still require the manual checks listed in known issues. Keep edits additive and preserve unsaved drafts, dialog return focus, and existing translated labels.