Appends the ## Architecture section to .convoys/unify-glass-panel-surfaces.md
ratifying the 4 open Decisions, and writes 7 implementer-brief files under
.convoys/unify-glass-panel-surfaces/.
Decisions ratified:
D1. <GlassSurface> grows a cornerLights='subtle'|'chrome'|'none' prop,
default 'subtle' (4-layer gradient-border per PR #118 recipe).
D2. Retire .card entirely; migrate all 8 consumers to .glass-panel.
D3. Mobile drawer uses subtle tier (.glass-panel-strong).
D4. CI gate scopes to JSX inline-style usage only; 3-entry allowlist
for documented chrome exceptions.
Briefs (1-7, all <100 LOC each, disjoint files):
1. Upgrade <GlassSurface> primitive (no deps, blocks 3+4)
2. Migrate auth form cards (parallel-safe)
3. Migrate floating popovers (sidebar dropdown, mobile drawer,
TopSearchBar UserMenu)
4. Migrate BulkSelectionToolbar + interior token sweep
5. Retire .card class; migrate 8 consumers
6. Migrate landing nav bar to .page-header-glass
7. forbidden-bespoke-glass-surface CI gate (runs LAST)
Boot-the-brief check: all 4-layer recipes verified against post-PR-#118
styles/globals.css; all box-shadow preservation chains verified against
current Layout.js + TopSearchBar.js; .card deletion verified clean
(single rule at L729-733); CI gate shape modeled on existing
forbidden-modal-shell-without-primitive job.
Architecture is read-only output — no application code touched.
Awaiting human gate 1 (plan approval) before implementers run.
Co-authored-by: Cursor <cursoragent@cursor.com>
4 KiB
| convoy | brief_number | depends_on | files | ||
|---|---|---|---|---|---|
| unify-glass-panel-surfaces | 2 |
|
Brief 2: Migrate auth form cards to .glass-panel-strong
Goal (1 sentence)
Replace the handrolled rgba(var(--bg-secondary-rgb), 0.85) + backdrop-blur-sm glass imitation on the login + signup form cards with the canonical .glass-panel-strong rounded-2xl p-8 className so the auth flow shares the rest of the app's surface treatment (corner catch-lights, system blur tier, gradient border).
Files in scope (do not edit anything else)
pages/login.js— replace the form-card container<div>(currently L82-88, look for theclassName="p-8 rounded-2xl shadow-2xl backdrop-blur-sm border border-opacity-20"+ inlinebackgroundColor: 'rgba(var(--bg-secondary-rgb), 0.85)').pages/signup.js— same migration on the form-card container (currently L227-232 in the symmetric<div className="p-8 rounded-2xl shadow-2xl backdrop-blur-sm ...">block).
Out of scope: the surrounding layout/header on either page, the <Input> / <Button> children, error/success banners, any of the legend/divider/social-button styling below the form. Do not touch them.
Conventions to follow
- Verbatim replacement for each card container:
The// Before: <div className="p-8 rounded-2xl shadow-2xl backdrop-blur-sm border border-opacity-20" style={{ backgroundColor: 'rgba(var(--bg-secondary-rgb), 0.85)', borderColor: 'var(--border)', }} > // After: <div className="glass-panel-strong rounded-2xl p-8">style={{}}block is removed entirely..glass-panel-strongalready composes the background, blur, rim, elevation, and the gradient-border treatment. - No new imports. This brief does NOT use
<GlassSurface>directly — the className path is correct because (a) it's an HTML div with no compositional requirements, (b) the existing.glass-panel-strongclass is the documented canonical shape per the design audit, and (c) using the class keeps the diff minimal. - Preserve children verbatim. The
<form>, every<Input>, every<Button>, the error banner, the social-sign-in divider, the "Don't have an account?" footer link — all stay byte-identical. - Do not adjust the surrounding header block (Deck Hearth logo +
greeting text); only the form-card
<div>itself migrates. - Tailwind safelist note:
.glass-panel-strongis defined instyles/globals.cssas a plain CSS class (not a Tailwind utility). It's already used in<Layout>and elsewhere, so the build picks it up via the@layerblock. Notailwind.config.jsedit needed.
Acceptance criteria
pages/login.jsform-card<div>usesclassName="glass-panel-strong rounded-2xl p-8"and carries no inlinebackgroundColor/borderColorstyle.pages/signup.jsform-card<div>usesclassName="glass-panel-strong rounded-2xl p-8"and carries no inlinebackgroundColor/borderColorstyle.- All form fields, labels, buttons, error banners, and footer
links render identically post-migration (manual smoke;
tests/smoke/auth.spec.jscontinues to pass without edits). - No edits to other files (e.g. no token additions in
styles/globals.css, no new components incomponents/ui/). npm run lintpasses;npm run test:runis unchanged (no test additions needed for a pure className swap).- Dark mode: card remains legible against the body background gradient (verify manually; before-shot vs after-shot screenshot attached to the PR description).
Rationale (≤3 sentences)
These two cards are the first surfaces a new user sees and they predate the .glass-panel-strong system; aligning them is both a correctness fix (the rgba(--bg-secondary-rgb, 0.85) shape doesn't compose corner lights) and a consistency win. The migration is a pure className swap with zero behavioral change — the lowest-risk brief in the convoy.