# Dark redesign: Site role changes (for the QA pass)

Owner: Site role. Date: 2026-11-17. Brief: `docs/DARK_REDESIGN_BRIEF.md`. Approved reference: `docs/samples/home-dark-concept.src.html`.

## Parity result (`php scripts/parity/check.php --base=http://127.0.0.1:8101 --no-write <page>`)

| Page | Result |
|---|---|
| about, contact, request-demo, talk-to-sales, privacy-policy, terms-condition | **PASS**, 0 differences (wording, links, titles, headings, images, iframes identical to original + approved layer) |
| home | 21 structural differences, listed below. No wording changed, no link missing, no text missing. |

`php artisan test`: 287 of 289 pass. The two failures are `PageParityTest` "home" and `test_approved_layer_catches_removed_words_and_reverted_changes` (which first requires home to pass); both fail only on the home differences below. Recording them in `scripts/parity/approved/home.json` (with the owner's approval of the concept as the reason) will turn them green; I did not edit the approved layer myself.

## Home: structural differences caused by the approved concept

1. **Order of sections (text moved).** The concept's order is: hero scene, services scene, statements, Leads & Website Optimization, turning screens, strengths, +500, Talk to Sales, #1 DMS close. The original order was hero, product boxes, intro, leads features, process steps, Talk to Sales, +500. Reported as "text moved":
   - "Preparing for your success is what it's all about." / "Make sure you're prepared in the right way." / "Meet Our Services": the services scene now comes before the six product links (the product links follow it as a row of icons + names). "Meet Our Services" is shown as the eyebrow above the title (visual `order`), DOM order kept title, text, link.
   - "Read More" (intro): sits right under the intro paragraph, before the three statements (concept), instead of after the bullet list.
   - "Test Drive Calendar", "SMS & Voice Call": the three feature titles are the giant changing title of the turning-screens scene, so the three titles come before the three texts in the DOM. Without JS / with reduced motion they are laid out per item (title, screen, text) in a 3-column grid, and one item after another on phones.
   - "Learn More" (website): after the three strengths instead of before the process steps.
   - "+500", "SATISFIED CLIENTS SERVED AROUND THE STATES !", "We're happy to know...": the proof block comes before Talk to Sales (concept order). Same headings and levels (h2, h3); the checker reports them as heading extra/missing because they moved.
2. **Pictures added by the design** (new `image` fields with alt text in `resources/content/home.php`):
   - `intro.background` (`screenmac3-scaled.webp`, was a CSS background) is now an `<img>` with alt "iDealers shown on a laptop" (`intro.background_alt`): the laptop rising in the services scene.
   - `intro.image` `marketingscreen-1.webp`, alt "iDealers dashboard with sales chart" (tilting dashboard).
   - `intro.studio_image` `design-studio-ui-1024x588.webp`, alt "iDealers Design Studio editing a car advert" (shutter reveal).
   - `intro.devices_image` `customwebsitescreen-1.webp`, alt "A dealership website shown on a desktop, laptop, tablet and phone" (devices glide in).
   - `leads.credit_screen` / `leads.calendar_screen` (were CSS backgrounds inside a device frame) are now `<img>` cards with new alt fields "Credit leads screen in iDealers" / "Test drive calendar in iDealers" (not flagged: the checker treats the old backgrounds as decorative).
   - Decorative duplicates of the product icons (floating chips, the orbit) are `aria-hidden` / `data-parity-ignore`.
3. **Removed decorations** (all decorative, empty alt or `aria-hidden` on the old page):
   - `/media/2022/12/blank.webp` (transparent click area over the old laptop video); the promo video now opens from a play button on the tilting dashboard (`intro.play_icon`, alt "Play the iDealers promo video", `data-video-popup`, `data-track="video_play"`).
   - `/media/2022/12/img-17.png` (floating decoration), the device frame `desktop-imac-minimal.png`, the custom white mouse cursor (`white-cursor.png`), and the Lottie animation `/media/2022/12/TrD2eun2wR.json` (reported as "Lottie source not found"). `lottie-web` is no longer imported (the package is still listed in `package.json`; nothing bundles it).
   - The old backgrounds `hero.background` (bkhero), `leads.background` (abanner.png), `sales.background` (bk2.webp) and the fields `intro.video_image(_alt)`, `leads.device_frame(_alt)`, `leads.decoration(_alt)`, `leads.cursor`, `leads.lottie` were removed from `home.php`. `clients.background` now points at `bkhero.webp` (the concept's proof picture) instead of `bodybk.webp`.
4. **Heading levels kept**: every old heading keeps its level (hero subtitle h2, intro title h2 + subtitle h3, leads title h2 + subtitle h3, the three feature titles h2, steps h3, clients h2 + h3, both sales lines h2). The h1 "A Modern Dealership Software" is one real, visible `<h1>`: "A Modern" and "Software" are visible text, the middle word is transparent text in place, drawn by the SVG light window (`hero.mask_word`).
5. **New text fields** (no visible new wording): `hero.mask_word` (which word of the h1 is the light window), `intro.title_highlight` and `sales.subtitle_highlight` (which words are mint), `intro.orbit_label` (screen-reader label of the orbit picture, wording from the concept).

## Shared layout (all 15 pages)

- **Header** sits over the first section (absolute, dark scrim), real logo image, top bar kept (social + phone), Products/Company dropdowns, Pricing, Dealership Login, Request A Demo (mint). Without JS on phones it becomes a normal block above the page so the fallback list never overlays content.
- **Hero second button** "Request A Demo" (home only, concept) repeats the header link: `data-parity-ignore`.
- **Footer** as in the concept: brand block (logo, tagline, phone; the block repeats header content so it is `data-parity-ignore`; new global field `footer.tagline` "A Modern Dealership Software"), the same four link columns + Follow Us icons, the flowing-colour "iDealers" wordmark (aria-hidden), copyright with the render-time year + "Cookie settings", credit.
- **Pre-footer** "#1 DMS Software" is the concept's closing section; the image `prefooter.image` (mac2.webp) is kept under the buttons on the teal glow. Home passes its "our features" link (clients button) as the gold tag above the title (new layout section `prefooter_tag`).
- **Error pages**: same message block, the code drawn in the flowing wordmark colours.
- `scripts/qa/contrast-collect.js`: skips text whose colour is fully transparent and has no gradient fill (not painted: the SVG-drawn h1 word, and the footer wordmark outline, a logotype).

## Other Site pages (all pass parity)

- About: hero (h1 + text + portrait), team picture opens like a shutter (kit `.vis.reveal`), Mission & Vision statement lights up word by word, success + video.
- Contact: hero with call/email boxes and the illustration gliding in (kit `.vis.slide`); questions + contact details beside the form on a light panel; success + video.
- Request A Demo: hero with the laptop tilting flat (kit `.vis.tilt`); form on a light panel (`data-hide-mobile-bar` kept); success + video.
- Talk To Sales: centred headline in dimmed living light (kit `.grad`); form on a light panel; success + video.
- Privacy Policy / Terms & Condition: title in a slow living-light band, text at 72ch with no scroll effects, styled cookie table.
- The email box icon on contact / request-demo is now an envelope (was a phone icon); icons are SVG, not content.
