# Feature: Branding (platform)

## Purpose

ServDiary visual identity: house + calendar mark, cyan/navy colour tokens, and favicon. Shared by marketing, Jetstream auth, and the authenticated shell.

## Boundaries

- **Owns:** `public/images/brand/servdiary-icon.png`, `public/favicon.ico`, `public/apple-touch-icon.png`, `resources/js/Components/BrandMark.vue`, Jetstream wrappers (`ApplicationMark`, `ApplicationLogo`, `AuthenticationCardLogo`), Tailwind `diary.*` tokens in `tailwind.config.js`
- **Does not own:** Product page layouts, invoice/quote PDFs, mail templates, Android/iOS launcher icons
- **Depends on (platform only):** Vite public assets, Inertia layouts
- **Depends on (other domains):** none
- **Removable?** No — shared kernel chrome

## Models

None.

## Routes

None. Assets are served from `public/`.

## Permissions

N/A.

## Design notes

### Mark

Transparent PNG of the house/calendar/checkmark (black canvas knocked out). Use `BrandMark` rather than inlining the image.

| Surface | Component | Typical size |
|---------|-----------|----------------|
| Sidebar / mobile nav | `ApplicationMark` | `h-8 w-8` |
| Wordmark (icon + “ServDiary”) | `ApplicationLogo` | mark `size-12` |
| Jetstream auth / terms | `AuthenticationCardLogo` | `size-16` |
| Marketing header | `BrandMark` in `MarketingLayout` | `size-9` |

### Tokens (`diary.*`)

Electric cyan (`diary-cyan`, `#00D4F5`) is a glow/accent on dark surfaces (hero CTAs, dark-mode links, focus rings). It is not body text on white.

Interactive colour on light backgrounds is `diary-teal` (`#0E7A96`) / `diary-teal-deep` (`#0A5A70`). Existing `diary-teal` / `diary-ink` class names stay; hues follow the icon.

| Token | Hex | Use |
|-------|-----|-----|
| `ink` | `#0B1A2B` | Body text on light |
| `navy` | `#001A33` | Icon fill, text on cyan CTAs |
| `cyan` | `#00D4F5` | Dark-surface accent, hero primary |
| `teal` | `#0E7A96` | Links, buttons, focus on light |
| `teal-deep` | `#0A5A70` | Hover/active on light |
| `mist` | `#E6F5FA` | Cool wash, dark-mode text |
| `fog` | `#F2F7FA` | Light page background |
| `sand` | `#D3E4EC` | Borders |

Favicon: `favicon.ico` plus PNG `/images/brand/servdiary-icon.png` and `apple-touch-icon.png`, linked from `resources/views/app.blade.php`.

## Tests

Covered by existing marketing and auth Feature tests (pages still render). Visual check: marketing home (stacked hero + diary preview), login, `/forgot-password`, dashboard sidebar light and dark.

## Add / remove checklist

### Add

- [x] Brand PNG + favicon
- [x] `BrandMark` wired through Jetstream + marketing
- [x] This wiki page linked from `docs/README.md`

### Remove

- [ ] Restore Jetstream SVGs and previous `diary` tokens
- [ ] Delete brand assets and this page