# Dark redesign: Products role changes

Role: Products. Date: 2026-11-17. Pages: idms-idealers-management-system, inventory-management, leads-center, website, marketing-tools, crm-system, design-studio-tool, pricing. Brief: `docs/DARK_REDESIGN_BRIEF.md`.

## Result of the checks (server on port 8102, SQLite override)

| Check | Result |
|---|---|
| `php scripts/parity/check.php --base=http://127.0.0.1:8102 --no-write` (8 pages) | 8 pass, 0 differences. Warnings only: `og:image` on five pages (see below, not changed by this phase). |
| `php scripts/qa/console.php` (8 pages) | 0 errors, 0 warnings, 0 CSP violations |
| `php scripts/qa/nojs.php` (8 pages) | 0 hidden content with JavaScript off and with reduced motion (wrote `docs/qa/nojs-latest.md`) |
| `php scripts/qa/contrast.php` 1440 and 390 (8 pages) | 0 failures (lowest 4.38 at 1440, 4.40 at 390, both large text) |
| Horizontal scroll (`scrollWidth`) at 390 and 1024 | none on any page |
| `php artisan test` | 287 of 289 pass. The 2 failures are the home page parity tests (`PageParityTest` data set "home" and `test_approved_layer_catches_removed_words_and_reverted_changes`, which needs home to pass first): the Site role's home page is still in progress. Admin save round-trip and SEO offers/FAQ tests pass. |

## Structural differences caused by the redesign (no wording, link, price or title changed)

Parity passes without new approval entries, so nothing here needs an entry in `scripts/parity/approved/`. Listed for the QA pass:

- **Markup rebuilt.** All eight views were rewritten from the generated Elementor structure (`p-sec / p-col / p-w`, spacers, shape dividers) to plain sections. Text order, heading levels and heading texts are unchanged on every page.
- **Device mockups.** The PNG device frames (`/media/devices/*`) are no longer shown; laptops, monitors, tablets and phones are drawn in CSS around the real screenshot. The screenshots are now `<img>` through `<x-media.img>` (before: CSS backgrounds) and carry the former frame alt text ("Laptop showing the iDealers inventory list", ...). The parity tool already treats a background and an `<img>` of the same file as the same image. The `/media/devices/*` files must stay: `og:image` on five pages points to them (see below).
- **Content files.** Removed fields that no longer render anything: `*.device_frame`, `*.device_frame_2`, `*.device_frame_3` (frame images) and `hero.cursor_image` / `test_drive.cursor_image` (the old custom mouse cursor, a plugin effect parity never counted). The `*.device_frame_alt*` fields stay (same keys, so saved overrides still apply) and are now labelled "screenshot alt text"; on Leads Center `hero.device_frame_alt` names the group of three lead screens (`role="group"` label).
- **Counters.** `<x-product.counter>` was removed; "+300" (Design Studio) and "100%" (Pricing) are rendered final on the server and counted up by the kit's `[data-count]`.
- **Leads Center hero.** The auto-playing monitor slider of three screens became the page's signature scene: all three screens are visible at once (fanned, then stacked as you scroll). No slide is hidden any more.
- **Design Studio collage** (`DesignStudioCollage-scaled.webp`) is now also shown on phones (it was hidden there); it is lazy-loaded through its existing AVIF/WebP variants.
- **Testimonials** keep the carousel (buttons, dots, keyboard, autoplay that pauses on hover/focus and now also off-screen); restyled as one large quote at a time.
- **Buttons** use the shared `.btn .btn--primary / .btn--ghost`; plan buttons keep `target="_blank" rel="noopener"`, `data-track="plan_click"` and `data-track-plan`; the six Stripe links are byte-identical (checked in the rendered HTML).
- **Plan feature highlight.** The content's inline `<span style="color: #d95754;">` ("All in Starter Plan") is shown in `--red` on the dark card (contrast); the content value is unchanged.
- **Comparison table** stays a real `<table>` in its own scroll container (`role="region"`, focusable); the feature column sticks on phones. Fixed: the screen-reader labels inside cells escaped the scroll container and widened the page on phones (container now `position: relative`).
- The hidden "Stickers & Buyer Guide" section on Inventory Management is still not rendered.

## Signature moment per page

| Page | Signature (kit hooks) | Rest of the page |
|---|---|---|
| IDMS | "Deals Management System": pinned scene, the deal-type monitor rises and the four deal tiles fly out of it and keep floating (`.scrub`, `--a/--b`) | hero with the dashboard tilting flat, intro statement in two columns, Deal Forms (large check lines + `.vis.reveal`), 24/7 Support (floating picture), Pre-Qualification (`.vis.tilt`), Reporting close |
| Inventory | VIN Decoding / Vehicles Media / Vehicles Details as 3D turning screens, each with its own heading and text (`.deck`, `.deck-desc`, `--k`) | hero laptop whose inventory list pans, intro |
| Leads Center | hero: three lead screens fanned out flow into one stack with mint pulse rings (pinned hero) | intro, Test Drive (`.tilt` monitor), Credit Leads (rising monitor, panning list), SMS (floating chat) |
| Website | hero: the laptop centre stage, tablet and phone glide in from the sides and assemble (pinned hero) | intro, Live Chat (`.tilt`), Responsive (rise), SEO (`.reveal`), Custom Design (`.slide`), Display Page (tablet, panning) |
| Marketing Tools | "Our Marketing Tools": the chat phone turns in the centre while the four tools light up around it one after another (pinned; one plain column on phones) | hero laptop, intro, Chatbot (`.reveal`), Social (float), Interface (tablet), Broadcasting (`.tilt`), GBM (float) |
| CRM System | "Quick Deals": the laptop lies flat, stands up and grows until the deal form fills the view (pinned) | hero laptop, intro, Non-Conflict Customers Data (float) |
| Design Studio | "Next Generation Creative Studio.": oversized lines, then the studio canvas opens like a shutter with a light sweep (pinned) | hero "Creative" in flowing living-light colours, giant "+300" and the drifting design collage, Social (`.tilt`), big-quote testimonials, plans + table + Talk to Sales |
| Pricing | the giant mint "100%" beside the floating illustration | plan cards, comparison table, FAQ, Talk to Sales, "Not sure which plan" with the phone number large |

Every scene is a plain readable section without JavaScript and under reduced motion (scroll-linked transforms only under `html.motion`); continuous animations sit inside `.vis` (paused off-screen by the kit) or carry `data-p-loop` (paused by `products.js`).

## Files

- Views: `resources/views/pages/{the eight}.blade.php` (rewritten).
- Components: new `product/title.blade.php` (heading with mint highlight); `product/device.blade.php` rewritten (CSS devices / white frame / no frame, optional pan); `product/pricing-table.blade.php` rewritten (cards); `talk-strip` uses `.btn`; `counter` and `cascading-images` deleted; `icon` lost the unused "comments" glyph.
- CSS: `resources/css/products.css` now imports `products/base.css`, `products/scenes.css`, `products/pricing.css` (all new). Deleted: `products/{device,buttons,widgets,motion,extras,overrides}.css` and `products/pages/*.css` (the old light design; product CSS went from about 6,700 lines to about 390).
- JS: `resources/js/products.js` reduced to the testimonial carousel and the off-screen pause for `[data-p-loop]`; entrance animations, counters, device sliders, scrolling screens and motion-x were removed (the kit does this now).

## Kit notes for the Site role (nothing blocking)

- `.vis.tilt` only moves `.shot`; Products adds the same transform for its CSS devices (`.tilt > .p-dev` in `products/base.css`). If the kit's selector became `.tilt > :is(.shot, .p-dev)` that rule could go.
- `.vis.slide img` crops 6% on each side (112% width in an `overflow-x: clip` box); fine for the device collage, so Products uses it only there.
- Products uses the header overlay offset `calc(var(--header-h) + 36px)` (36px top bar) on desktop and `var(--header-h)` at <=767px for its heroes; if the header height changes, only `--p-top` in `products/base.css` needs updating.

## For the owner / SEO

- `og:image` on Inventory, Leads Center, Website, Marketing Tools and CRM is still a device-frame PNG (`/media/devices/*.png`), as before this phase (parity warning, not a failure). A screenshot of the product would be a better share picture; the SEO role owns that choice.
