A full-featured CRM built with React, shadcn/ui, and Supabase.
reduce size
erwanMarmelabdbdd4fce2818
diff --git a/.claude/skills/update-branding/SKILL.md b/.claude/skills/update-branding/SKILL.mdindex f05b09d8..63963e52 100644--- a/.claude/skills/update-branding/SKILL.md+++ b/.claude/skills/update-branding/SKILL.md@@ -5,77 +5,44 @@ description: Rebrand Atomic CRM — change the application logo (the wordmark in# update-branding-Changes the CRM **logo** and/or **title**. The logo appears in **two themes** and on **four screens**, and the title is hardcoded in **three** independent places — so a naive single-file replacement usually leaves one of them stale, which is why this normally takes several prompts. Follow the steps below to get it right in one pass.+Changes the CRM **logo** and/or **title**. The logo shows in **two themes** across **five screens** (desktop + mobile header, login, signup, confirmation) and the title is hardcoded in **three** places — a naive single-file edit leaves one stale. The steps below catch all of them.-## What "the logo" actually is+## Logo: two asset families-There are **two separate asset families**. Confirm with the user which they mean — most "change the logo" requests mean only the first.+Confirm which the user means — most requests mean only #1.-1. **The app logo / wordmark** (the common case) — `public/logos/`:- - `logo_atomic_crm_dark.svg` — **light-colored** art (white fill), shown when the app is in **dark mode** and on every auth page.- - `logo_atomic_crm_light.svg` — **dark-colored** art (black fill), shown when the app is in **light mode**.- - `logo_atomic_crm.svg` — a standalone copy (identical to the dark one); not wired to anything in the app, safe to update for consistency or ignore.+1. **App logo / wordmark** (common) — `public/logos/`. `logo_atomic_crm_dark.svg` is **light-colored** art shown in **dark mode** + all auth pages; `logo_atomic_crm_light.svg` is **dark-colored** art shown in **light mode**. (`logo_atomic_crm.svg` is an unused standalone copy.)+ > Files are named by **the mode they display in**, not their color — the "dark-mode" logo must read on a dark background.+2. **Favicon + PWA icons** — only if asked. Much bigger (34 PNGs); see [below](#favicon--app-icons-optional).- > Naming is by **the mode it displays in**, not the art's color. The "dark-mode" logo must read on a dark background (so it's light), and vice-versa.+## Code defaults vs. runtime Settings — they conflict-2. **The favicon + PWA icons** (only if the user asks for the browser-tab / installed-app icon) — see [Favicon & app icons](#favicon--app-icons-optional). This is a much bigger job (34 sized PNGs) and is **out of scope unless explicitly requested**.+- **Code defaults (this skill):** edit `defaultConfiguration.ts` + assets. Committed, applies everywhere, and the only way to change the browser-tab title / favicon / PWA icons.+- **Settings UI** (`/settings` → Branding, [`SettingsPage.tsx`](../../../src/components/atomic-crm/settings/SettingsPage.tsx)): a logged-in user edits title + uploads logos, **per-browser**, saved to `localStorage` as `CRM.app.configuration` (logos as base64), never committed. Covers only the in-app logo + header title.-## Two ways to change the logo/title — pick the right one--There are **two independent mechanisms**, and confusing them is the #1 source of "I changed it but nothing happened":--1. **Code-level defaults (what this skill does).** Edits `defaultConfiguration.ts` + the asset files. **Committed to the repo, applies to every user and deployment**, and is the only way to also change the browser-tab title / favicon / PWA icons.-2. **Runtime Settings UI.** The in-app **`/settings` page → "Branding" section** ([`settings/SettingsPage.tsx`](../../../src/components/atomic-crm/settings/SettingsPage.tsx)) lets a logged-in user edit the `title` and upload light/dark logos with **no code change**. But this is **per-browser**: it's saved in `localStorage` under `CRM.app.configuration` (uploaded logos are stored as base64, *not* written to `public/logos/`), never committed, and covers **only** the in-app header/auth logo + header title — not the browser-tab title, favicon, or PWA manifest.--> ⚠️ **The store shadows the code.** `useConfigurationContext` returns `{ ...defaultConfiguration, ...storedConfig }` ([`ConfigurationContext.tsx`](../../../src/components/atomic-crm/root/ConfigurationContext.tsx)). So if branding was **ever** saved via `/settings`, the stored value wins and your edits to `defaultConfiguration.ts` won't show in that browser. To make code defaults take effect again, clear the `CRM.app.configuration` key from `localStorage` (or re-save matching values in `/settings`). Suspect this whenever a code change appears to have no visual effect.--Use the code path (this skill) for a permanent, shipped rebrand; point the user to `/settings` for a quick per-user tweak.--## Where the app logo is wired--- **Config (source of truth for defaults):** `src/components/atomic-crm/root/defaultConfiguration.ts`- ```ts- export const defaultDarkModeLogo = "./logos/logo_atomic_crm_dark.svg";- export const defaultLightModeLogo = "./logos/logo_atomic_crm_light.svg";- ```- These can also be overridden per-deployment via `<CRM darkModeLogo=… lightModeLogo=… />` in `src/App.tsx` (currently `<CRM />`, so the defaults apply). At runtime, a saved Settings value overrides all of these (see above).-- **Consumers** (no edits needed if you keep the config keys; listed so you can verify):- - `layout/Header.tsx` — renders **both**, toggled by CSS (`[.light_&]:hidden` / `[.dark_&]:hidden`), height `h-6`. Any aspect ratio works.- - `login/LoginPage.tsx`, `login/SignupPage.tsx`, `login/ConfirmationRequired.tsx` — render **only `darkModeLogo`** (dark backgrounds). A logo that only reads on a light background will be invisible here.+> ⚠️ **The store shadows the code.** `useConfigurationContext` returns `{ ...defaultConfiguration, ...storedConfig }` ([`ConfigurationContext.tsx`](../../../src/components/atomic-crm/root/ConfigurationContext.tsx)). If branding was ever saved via `/settings`, your edits to `defaultConfiguration.ts` won't show in that browser — clear the `CRM.app.configuration` localStorage key. Suspect this whenever a code change has no visual effect.## Steps-1. **Gather the asset(s).** Ask the user for the new logo file path or URL, and whether they have **separate light/dark variants** or a single image. Note the format (SVG vs PNG).- - One variant only → set both config keys to it, and **warn** it may have poor contrast in one theme (especially the auth pages, which always use the dark-mode key).- - SVG with a single solid fill → you can derive the other variant by swapping the fill color (e.g. `white` ↔ `black`); confirm the result reads in both themes.-2. **Place the files** in `public/logos/`. Pick one approach:- - **Drop-in (simplest, no code change):** overwrite `logo_atomic_crm_dark.svg` / `logo_atomic_crm_light.svg`, keeping the **exact filenames and `.svg` extension**. Only valid if the new asset is also SVG. The config already points here, so you're done after this.- - **New name or different format (e.g. PNG):** save as new files (e.g. `logo_company_dark.png`), then update the two consts in `defaultConfiguration.ts` to match (paths are relative to `public/`, so `"./logos/<file>"`).-3. **Update the title**, if the brand name is changing too. It lives in **three independent places** — `defaultTitle` drives only the in-app one, so the other two stay stale unless edited by hand:- - `defaultConfiguration.ts` → `defaultTitle` — the header `<h1>` and the logo `alt` text (also overridable via `<CRM title=… />`).- - `index.html` → `<title>…</title>` — the **browser-tab** title. Hardcoded; no `document.title` is set at runtime, so it does **not** follow `defaultTitle`.- - `public/manifest.json` → `short_name` and `name` — the **installed-PWA** name.-4. **Verify** (below).+1. **Gather the asset(s).** Ask for the file/URL, format (SVG vs PNG), and whether there are **separate light/dark variants** or one image.+ - One variant → set both config keys to it; **warn** about poor contrast in one theme (auth pages always use the dark-mode key).+ - Single-fill SVG → derive the other variant by swapping the fill (`white` ↔ `black`).+2. **Place the files** in `public/logos/`:+ - **Drop-in (simplest):** overwrite `logo_atomic_crm_dark.svg` / `logo_atomic_crm_light.svg`, keeping the exact filenames + `.svg`. Config already points here — done. (SVG only.)+ - **New name / format (e.g. PNG):** save as new files, then update the two consts in `defaultConfiguration.ts` (`defaultDarkModeLogo`, `defaultLightModeLogo`; paths relative to `public/`, so `"./logos/<file>"`).+3. **Update the title** (if the name changes) in all **three** places — `defaultTitle` drives only the first:+ - `defaultConfiguration.ts` → `defaultTitle` — header `<h1>` + logo `alt`.+ - `index.html` → `<title>` — browser-tab title (hardcoded, not set at runtime).+ - `public/manifest.json` → `short_name` + `name` — installed-PWA name.-## Favicon & app icons (optional)--Only if the user asks to change the browser-tab / installed-app icon. These are **not** SVGs and are referenced by `index.html` and `public/manifest.json`:-- `public/favicon.ico`-- `public/appIcon/*.png` — 34 files across many sizes, including `maskable_icon*` variants.--Doing this properly means regenerating **every** size from one square source (use a tool like `sharp`/`pwa-asset-generator`, or ask the user to provide the set). Don't hand-edit a few and leave the rest mismatched — **flag the full list to the user** and confirm scope before starting. The `theme_color`/`background_color` in `manifest.json` may also need updating to match the new brand.--> The documentation site logo (`doc/astro.config.mjs` → `doc/public/logo_atomic_crm_*.svg`) is a **separate** Astro site, not the app. Leave it unless the user explicitly asks to rebrand the docs.+Consumers (no edits if you keep the config keys): `layout/Header.tsx` + `dashboard/MobileDashboard.tsx` render both variants (CSS-toggled, `h-6`); `login/{LoginPage,SignupPage,ConfirmationRequired}.tsx` render **only** `darkModeLogo`.## Verify-```bash-make typecheck # only catches config-key typos; the rest is visual-```+`make typecheck` catches only config-key typos. Then `make start` and check: header in **both themes**, **desktop + mobile**; the **login/signup** pages (dark bg); and if the title changed, the header `<h1>`, browser tab, and PWA name. A logo wrong in exactly one theme means both keys point at one asset, or the light/dark files are swapped.++## Favicon & app icons (optional)-Then run the app (`make start`) and check **all four** surfaces, since the two themes use different files:-- Header in **light mode** and in **dark mode** (toggle the theme) — correct logo, legible, not stretched.-- The **login page** (and signup/confirmation) — uses the dark-mode logo on a dark background.-- If the title changed: the **header `<h1>`**, the **browser-tab** title (`index.html`), and the **PWA name** (`manifest.json`) all read the new brand.+Only if asked. Referenced by `index.html` + `public/manifest.json`: `public/favicon.ico` and `public/appIcon/*.png` (34 sizes incl. `maskable_icon*`). Regenerate **every** size from one square source (`sharp` / `pwa-asset-generator`) or ask the user for the set — don't hand-edit a few. Confirm scope first; `theme_color`/`background_color` in `manifest.json` may also need updating.-If the logo looks wrong in exactly one theme, you likely set both config keys to the same single-color asset, or swapped the light/dark files.+> The docs-site logo (`doc/astro.config.mjs` → `doc/public/logo_atomic_crm_*.svg`) is a separate Astro site — leave it unless asked.