# Theme

Theme assembly lives in `src/theme`.

- Global tokens and defaults: `src/theme/theme-config.ts`
- Project branding overrides: `src/theme/theme-overrides.ts`
- Palette: `src/theme/core/palette.ts`
- Typography: `src/theme/core/typography.ts`
- MUI component defaults: `src/theme/core/components/`
- Runtime settings integration: `src/theme/with-settings/`

Use theme tokens in `sx`: `primary.main`, `text.secondary`, `background.paper`, `divider`, and `theme.spacing()`. Never add hardcoded hex colors to feature screens. Brand changes belong in `theme-overrides.ts`.

Keep layouts direction-neutral. Test every new feature in Arabic RTL and English LTR using the header language switcher.