# Dark redesign: brief

Author: Claude Fable 5.2. Implementation: Claude Opus 5.5 agents. Date: 2026-11-17.

The owner approved a new design for the home page after several rounds of feedback and said "apply it". This phase builds that design into the real site and carries the same visual language across the other 14 pages.

## The approved reference

- `docs/samples/home-dark-concept.src.html`: the approved home page (CSS, markup and JS, with `{{NAME}}` placeholders where images go). **This is the specification for the home page.** Read it in full.
- `docs/samples/home-dark-concept.html`: the same with images inlined, to open in a browser.
- Placeholders map to these existing files: `{{MAC}}` `/media/2022/12/screenmac3-scaled.webp`; `{{CARS}}` `/media/2023/11/bkhero.webp`; `{{L0}}` `creditscreen.webp`, `{{L1}}` `testdrivescreen.webp`, `{{L2}}` `smsscreen.webp` (all `/media/2022/12/`); `{{D0}}` `/media/2022/12/marketingscreen-1.webp` (dashboard); `{{D1}}` `/media/2023/12/design-studio-ui-1024x588.webp`; `{{D2}}` `/media/2022/12/customwebsitescreen-1.webp`; `{{I0}}`-`{{I5}}` `/media/2024/01/{ids,inventory,leads,website,marketing,crm}.webp`.

What the owner explicitly chose, so do not change it:

1. Dark, cinematic palette (below). No light sections.
2. Hero: the word DEALERSHIP as a window onto drifting coloured light with light trails ("living light"), no photo; scrolling flies through the letters; it lands on "All you need in one platform" with the product names over a teal glow, **with no laptop in that landing**.
3. Next scene: "Preparing for your success..." with the laptop rising and the product names lighting up.
4. Statements that light up word by word, each paired with a moving picture: dashboard tilting flat with floating product icons; shutter-reveal with light sweep; devices gliding in; and, for "No more juggling...", product icons that tumble in and settle into orbits around one iDealers hub (the owner rejected a static screenshot here).
5. Lead tools as 3D turning screens with a changing giant title.
6. Strengths as three oversized sliding lines. No card grids, no tabs, no numbered boxes anywhere (the owner rejected those).
7. A large "+500" counter, Talk to Sales, and the "#1 DMS Software" close.
8. Footer: all the old footer links in columns, social icons, and a giant "iDealers" wordmark filled with flowing colour, a moving light sweep, and a cursor spotlight on desktop.
9. Reference the owner named for taste: apple.com (very large type, the product as the star, scroll-linked motion, lots of space).

## Design system

Tokens (replace the light values in `resources/css/site/tokens.css`; keep token names that other CSS uses and re-point them, add these):

```
--night: #050d0b;  --night-2: #0a1815;  --ink: #f2f8f7;  --soft: #a9c2bd;  --dim: #5d7772;
--line: rgba(255,255,255,.14);  --mint: #00d8c1;  --teal: #00a795;  --red: #ff5a6a;  --gold: #feba19;
living-light colours: #00d8c1, #ff3b4e, #feba19, #1f6bff
```

- Fonts stay Poppins (display) and Rubik (body); the type-scale tokens stay, and display headings may go larger as in the concept.
- Primary button: mint fill, dark text `#04201c`, soft mint glow. Secondary: 1.5px white outline. Text links: mint.
- Screenshots sit in a thin white frame with a mint glow, or frameless on a glow.
- `color-scheme: dark` on the root. Every text/background pair still meets WCAG AA (4.5:1 normal text, 3:1 large text); `--dim` is for large or decorative text only.

## Shared motion kit (the Site role builds this first; both roles use it)

Files: `resources/css/site/motion.css` (imported by `site.css`) and `resources/js/site/motion.js` (imported by `site.js`). Lift the mechanics from the concept and make them generic:

| Hook | Behaviour |
|---|---|
| `<section class="scrub" data-scrub>` with a first child `.stage` | Pinned scene. JS sets `--p` (0..1 scroll progress), `--a` (first 55%) and `--b` (last 45%) on the section. Optional `style="--travel:1300px"`. |
| `data-lit` on any element | JS sets `--v` (0..1) as the element enters the viewport. |
| `.lit[data-lit]` | Text split into word spans that brighten in order (`--i`, `--n`); a child with class `hi` is mint. |
| `.duo` / `.duo.flip`, `.txt`, `.vis` | Statement beside a moving picture, alternating sides, one column on phones. |
| `.vis.tilt`, `.vis.reveal`, `.vis.slide`, `.vis.orbit` | The four picture motions from the concept. |
| `.deck` with `.c` cards and `--k` | 3D turning screens. |
| `.row[data-lit]` | Oversized sliding line with a description. |
| `.grad` with `i.g1`-`i.g4` and `.trail` | Living-light fill. |
| `.fword` | Footer wordmark. |

Rules for all motion: content is readable with JavaScript off and at rest; `prefers-reduced-motion` collapses pinned scenes to plain stacked sections with everything visible and stops continuous animation; continuous animations pause when off-screen (IntersectionObserver) and the living light is simplified on phones; animate only `transform`, `opacity`, `clip-path` and background position; no layout shift; no horizontal page scroll at any width.

## Rules that still apply

- **Wording does not change.** Every text, link, image and alt text currently on each page stays, read from the content files (`resources/content/*.php`) so it remains editable in the admin. The concept shows the home page's main texts; anything else the home page has today (for example the promo video, "Learn More" links, process steps, and any other field in `home.php`) must still appear, presented in the new style. New pictures the design introduces become `image` fields in the content file with real alt text. Follow the content contract in `docs/PROJECT_OUTLINE.md` section 6.2.
- **Parity:** `php scripts/parity/check.php` compares each page with the original plus approved changes (`scripts/parity/approved/`, see `docs/qa/PARITY.md`). Text, links, titles and headings must still pass. Purely structural differences caused by the redesign (heading level changes, images added by the design, decorative duplicates marked `aria-hidden` or `data-parity-ignore`) are recorded in `docs/handoff/dark-changes-{role}.md` for the QA pass; missing or changed wording is a defect.
- **Real headings:** each page has exactly one visible, real `<h1>` (on home: "A Modern Dealership Software"; the big DEALERSHIP lettering can be the SVG, but the heading text must be real, visible text and not hidden off-screen: for example make "A MODERN", "DEALERSHIP" and "SOFTWARE" one `<h1>` whose middle word is visually replaced by the SVG while remaining in the accessibility tree). No skipped heading levels.
- Keep what the last phase delivered: `<x-media.img>` for content images (hero image `eager`), the phone bottom bar (Call / Request A Demo) and full-screen menu, the cookie notice with Accept/Decline and the footer "Cookie settings" link, `data-track` attributes, the pricing comparison table, FAQ and Talk to Sales strip, the three idealers.app form embeds, the six Stripe links byte-identical, SEO head and JSON-LD untouched.
- Content-Security-Policy is strict: no inline event handlers; inline `<script>`/`<style>` need `nonce="{{ $cspNonce }}"`; inline `style=""` attributes are allowed; no new third-party hosts.
- Performance: no new image above 250 KB; nothing heavy loads before it is needed; keep the home page's total transfer at or below its current value in `docs/qa/performance.md`.
- No `git`, no `composer require`, no `migrate:fresh`. `.env` currently points at an empty MySQL database: run your server with process environment overrides instead of editing `.env`:
  `DB_CONNECTION=sqlite DB_DATABASE="<absolute path>/database/database.sqlite" php artisan serve --port=<yours>`
- A backup of the previous design is at `storage/app/backups/pre-dark-redesign-2026-11-17.tar.gz`. Do not delete it.
- Headless Chrome helpers: `scripts/qa/lib/cdp.php`, `scripts/qa/screenshots.php`, `scripts/qa/console.php`, `scripts/qa/contrast.php`. Keep each command short-running.

## Team

| Role | Port | Owns |
|---|---|---|
| **Site** | 8101 | tokens, motion kit, `resources/css/site.css` and `site/**`, `resources/js/site.js` and `site/**`, layouts, `components/ui/**`, `components/site/**` (header, top bar, footer, pre-footer, mobile bar and menu, cookie notice, video modal, error pages), and the pages home, about, contact, request-demo, talk-to-sales, privacy-policy, terms-condition with their content files and `_global.php` |
| **Products** | 8102 | `components/product/**`, `resources/css/products.css` and `products/**`, `resources/js/products.js`, and the pages idms-idealers-management-system, inventory-management, leads-center, website, marketing-tools, crm-system, design-studio-tool, pricing with their content files |

The other 14 pages have no approved mock-up. Design them as the same site as the approved home page: the same palette, type, spacing and motion vocabulary, one idea per screen, the product screenshots as the stars, big statements instead of boxes. Each page gets one signature moment built from the kit (a pinned scene or a strong picture motion) and otherwise calm, readable sections. Legal pages and forms stay simple and highly readable (comfortable line length, no scroll tricks on long text).

Final report: what was built per page, how it was verified (commands and what you looked at), what differs from the approved concept and why, what is unfinished, and anything needing the owner.
