diff --git a/.gitignore b/.gitignore index 375f8be..926ed22 100644 --- a/.gitignore +++ b/.gitignore @@ -1,3 +1,9 @@ node_modules/ .wrangler/ .DS_Store + +# Impeccable working files: mockups, review captures, build state. The surface brief and live config are kept. +.impeccable/mocks/ +.impeccable/review/ +.impeccable/build/ +.impeccable/questions/ diff --git a/.impeccable/design.json b/.impeccable/design.json new file mode 100644 index 0000000..b42f7dc --- /dev/null +++ b/.impeccable/design.json @@ -0,0 +1,374 @@ +{ + "schemaVersion": 2, + "generatedAt": "2026-11-05T20:36:33+00:00", + "title": "Design System: Selfie", + "extensions": { + "colorMeta": { + "sky": { + "role": "neutral", + "displayName": "Sky", + "canonical": "oklch(87.3% 0.042 245.0)", + "tonalRamp": [ + "oklch(15% 0.015 245.0)", + "oklch(26% 0.025 245.0)", + "oklch(37% 0.036 245.0)", + "oklch(48% 0.042 245.0)", + "oklch(59% 0.042 245.0)", + "oklch(70% 0.038 245.0)", + "oklch(82% 0.025 245.0)", + "oklch(94% 0.013 245.0)" + ] + }, + "ink": { + "role": "neutral", + "displayName": "Primer Ink", + "canonical": "oklch(25.4% 0.011 254.0)", + "tonalRamp": [ + "oklch(15% 0.004 254.0)", + "oklch(26% 0.007 254.0)", + "oklch(37% 0.009 254.0)", + "oklch(48% 0.011 254.0)", + "oklch(59% 0.011 254.0)", + "oklch(70% 0.010 254.0)", + "oklch(82% 0.007 254.0)", + "oklch(94% 0.003 254.0)" + ] + }, + "muted": { + "role": "neutral", + "displayName": "Primer Muted", + "canonical": "oklch(43.5% 0.019 254.0)", + "tonalRamp": [ + "oklch(15% 0.007 254.0)", + "oklch(26% 0.011 254.0)", + "oklch(37% 0.016 254.0)", + "oklch(48% 0.019 254.0)", + "oklch(59% 0.019 254.0)", + "oklch(70% 0.017 254.0)", + "oklch(82% 0.011 254.0)", + "oklch(94% 0.006 254.0)" + ] + }, + "paper": { + "role": "neutral", + "displayName": "Paper", + "canonical": "oklch(100% 0 0)", + "tonalRamp": [ + "oklch(15% 0.000 0.0)", + "oklch(26% 0.000 0.0)", + "oklch(37% 0.000 0.0)", + "oklch(48% 0.000 0.0)", + "oklch(59% 0.000 0.0)", + "oklch(70% 0.000 0.0)", + "oklch(82% 0.000 0.0)", + "oklch(94% 0.000 0.0)" + ] + }, + "yellow": { + "role": "primary", + "displayName": "Button Yellow", + "canonical": "oklch(87.9% 0.168 95.4)", + "tonalRamp": [ + "oklch(15% 0.059 95.4)", + "oklch(26% 0.101 95.4)", + "oklch(37% 0.143 95.4)", + "oklch(48% 0.168 95.4)", + "oklch(59% 0.168 95.4)", + "oklch(70% 0.151 95.4)", + "oklch(82% 0.101 95.4)", + "oklch(94% 0.050 95.4)" + ] + }, + "cam-yellow": { + "role": "secondary", + "displayName": "Camera Chrome Yellow", + "canonical": "oklch(88.5% 0.181 94.8)", + "tonalRamp": [ + "oklch(15% 0.063 94.8)", + "oklch(26% 0.109 94.8)", + "oklch(37% 0.154 94.8)", + "oklch(48% 0.181 94.8)", + "oklch(59% 0.181 94.8)", + "oklch(70% 0.163 94.8)", + "oklch(82% 0.109 94.8)", + "oklch(94% 0.054 94.8)" + ] + }, + "hot-pink": { + "role": "tertiary", + "displayName": "Annotation Hot Pink", + "canonical": "oklch(66.0% 0.255 355.0)", + "tonalRamp": [ + "oklch(15% 0.089 355.0)", + "oklch(26% 0.153 355.0)", + "oklch(37% 0.217 355.0)", + "oklch(48% 0.255 355.0)", + "oklch(59% 0.255 355.0)", + "oklch(70% 0.230 355.0)", + "oklch(82% 0.153 355.0)", + "oklch(94% 0.076 355.0)" + ] + }, + "signal-pink": { + "role": "tertiary", + "displayName": "Signal Pink", + "canonical": "oklch(65.8% 0.200 353.5)", + "tonalRamp": [ + "oklch(15% 0.070 353.5)", + "oklch(26% 0.120 353.5)", + "oklch(37% 0.170 353.5)", + "oklch(48% 0.200 353.5)", + "oklch(59% 0.200 353.5)", + "oklch(70% 0.180 353.5)", + "oklch(82% 0.120 353.5)", + "oklch(94% 0.060 353.5)" + ] + }, + "screen-black": { + "role": "neutral", + "displayName": "Screen Black", + "canonical": "oklch(16.9% 0.004 286.0)", + "tonalRamp": [ + "oklch(15% 0.001 286.0)", + "oklch(26% 0.002 286.0)", + "oklch(37% 0.003 286.0)", + "oklch(48% 0.004 286.0)", + "oklch(59% 0.004 286.0)", + "oklch(70% 0.004 286.0)", + "oklch(82% 0.002 286.0)", + "oklch(94% 0.001 286.0)" + ] + }, + "slate-note": { + "role": "neutral", + "displayName": "Slate Note", + "canonical": "oklch(76.5% 0.021 250.4)", + "tonalRamp": [ + "oklch(15% 0.007 250.4)", + "oklch(26% 0.013 250.4)", + "oklch(37% 0.018 250.4)", + "oklch(48% 0.021 250.4)", + "oklch(59% 0.021 250.4)", + "oklch(70% 0.019 250.4)", + "oklch(82% 0.013 250.4)", + "oklch(94% 0.006 250.4)" + ] + } + }, + "typographyMeta": { + "display": { + "displayName": "Display", + "purpose": "The hero headline; desktop size is 82 comp units, italic word at the same weight 600." + }, + "headline": { + "displayName": "Headline", + "purpose": "Section heads; italic words inside drop to 600." + }, + "title": { + "displayName": "Title", + "purpose": "Hero argument line; the 600-weight family of smaller titles (1.375rem video titles, 1.25rem feature names)." + }, + "body": { + "displayName": "Body", + "purpose": "Running copy, held to about 42-48em." + }, + "label": { + "displayName": "Label", + "purpose": "Fine print; the notice strip uses 1.0625rem." + }, + "hand": { + "displayName": "Hand", + "purpose": "Neucha handwriting on the artwork only: the note and the print caption." + }, + "code": { + "displayName": "Code", + "purpose": "Inline code and the terminal." + } + }, + "shadows": [ + { + "name": "pressable", + "value": "4px 4px 0 #1f2328", + "purpose": "Buttons at rest; the shadow is the button travel." + }, + { + "name": "pressable-hover", + "value": "5px 5px 0 #1f2328", + "purpose": "Button hover, with a -1px translate." + }, + { + "name": "pressable-active", + "value": "1px 1px 0 #1f2328", + "purpose": "Button press, with a 3px translate." + }, + { + "name": "print-drop", + "value": "0.6cqw 0.8cqw 1.6cqw rgb(31 35 40 / 0.18)", + "purpose": "The paper print of yesterday, the one soft shadow." + } + ], + "motion": [ + { + "name": "press", + "value": "0.12s ease-out", + "purpose": "Button and shutter transform and shadow." + }, + { + "name": "flash", + "value": "0.32s ease-out", + "purpose": "White screen flash when the shutter fires." + }, + { + "name": "arrow-draw", + "value": "0.6s 0.6s cubic-bezier(0.3, 0, 0.2, 1)", + "purpose": "The annotation arrow draws in from the note; head follows at 0.22s after 1.15s. Skipped under reduced motion." + }, + { + "name": "note-in", + "value": "0.35s 0.35s ease-out", + "purpose": "The handwritten note fades in before the arrow." + } + ], + "breakpoints": [ + { + "name": "phone", + "value": "600px" + }, + { + "name": "stack", + "value": "860px" + }, + { + "name": "stage", + "value": "1100px" + } + ] + }, + "components": [ + { + "name": "Primary Button", + "kind": "button", + "refersTo": "button-primary", + "description": "Yellow, ink-outlined, hard offset shadow that moves with hover and press. The main call to action.", + "html": "Get started on GitHub", + "css": ".ds-btn { display: inline-block; padding: 0.7rem 1.25rem; font-family: Jost, system-ui, sans-serif; font-size: 1.1875rem; font-weight: 600; color: var(--ink, #1f2328); text-decoration: none; border: 3px solid var(--ink, #1f2328); border-radius: 12px; box-shadow: 4px 4px 0 var(--ink, #1f2328); transition: transform 0.12s ease-out, box-shadow 0.12s ease-out; } .ds-btn:hover { transform: translate(-1px, -1px); box-shadow: 5px 5px 0 var(--ink, #1f2328); } .ds-btn:active { transform: translate(3px, 3px); box-shadow: 1px 1px 0 var(--ink, #1f2328); } .ds-btn:focus-visible { outline: 3px solid var(--pink, #e8509b); outline-offset: 3px; } .ds-btn-primary { background: var(--yellow, #f9d535); }" + }, + { + "name": "Dark Button", + "kind": "button", + "refersTo": "button-dark", + "description": "Ink fill, white text; a second action on the yellow band.", + "html": "Read the quickstart", + "css": ".ds-btn { display: inline-block; padding: 0.7rem 1.25rem; font-family: Jost, system-ui, sans-serif; font-size: 1.1875rem; font-weight: 600; color: var(--ink, #1f2328); text-decoration: none; border: 3px solid var(--ink, #1f2328); border-radius: 12px; box-shadow: 4px 4px 0 var(--ink, #1f2328); transition: transform 0.12s ease-out, box-shadow 0.12s ease-out; } .ds-btn:hover { transform: translate(-1px, -1px); box-shadow: 5px 5px 0 var(--ink, #1f2328); } .ds-btn:active { transform: translate(3px, 3px); box-shadow: 1px 1px 0 var(--ink, #1f2328); } .ds-btn:focus-visible { outline: 3px solid var(--pink, #e8509b); outline-offset: 3px; } .ds-btn-dark { background: var(--ink, #1f2328); color: #fff; }" + }, + { + "name": "Secondary Button", + "kind": "button", + "refersTo": "button-secondary", + "description": "White fill, ink text, same outline and shadow.", + "html": "Join the list", + "css": ".ds-btn { display: inline-block; padding: 0.7rem 1.25rem; font-family: Jost, system-ui, sans-serif; font-size: 1.1875rem; font-weight: 600; color: var(--ink, #1f2328); text-decoration: none; border: 3px solid var(--ink, #1f2328); border-radius: 12px; box-shadow: 4px 4px 0 var(--ink, #1f2328); transition: transform 0.12s ease-out, box-shadow 0.12s ease-out; } .ds-btn:hover { transform: translate(-1px, -1px); box-shadow: 5px 5px 0 var(--ink, #1f2328); } .ds-btn:active { transform: translate(3px, 3px); box-shadow: 1px 1px 0 var(--ink, #1f2328); } .ds-btn:focus-visible { outline: 3px solid var(--pink, #e8509b); outline-offset: 3px; } .ds-btn-secondary { background: #fff; }" + }, + { + "name": "Notice Strip", + "kind": "nav", + "refersTo": "notice-strip", + "description": "Top ink strip with one sentence and one yellow link; the only navigation.", + "html": "", + "css": ".ds-strip { display: flex; flex-wrap: wrap; align-items: baseline; justify-content: center; gap: 0.25rem 1.25rem; padding: 0.7rem 1.25rem; background: var(--ink, #1f2328); color: #fff; font-family: Jost, system-ui, sans-serif; font-size: 1.0625rem; line-height: 1.5; } .ds-strip p { margin: 0; } .ds-strip a { color: var(--yellow, #f9d535); font-weight: 600; white-space: nowrap; text-underline-offset: 0.15em; } .ds-strip a:hover { text-decoration-thickness: 2px; } .ds-strip a:focus-visible { outline: 3px solid var(--pink, #e8509b); outline-offset: 3px; } .ds-arrow { display: inline-block; width: 0.95em; height: 0.95em; margin-left: 0.15em; vertical-align: -0.12em; fill: none; stroke: currentColor; stroke-width: 1.8; stroke-linecap: round; stroke-linejoin: round; }" + }, + { + "name": "Video Card", + "kind": "card", + "refersTo": "video-thumb", + "description": "16:9 thumbnail in a 3px ink frame, no shadow, with a signal-pink play disc; title and muted description below.", + "html": "Product demoA two-line CSS change touches all 124 stories.", + "css": ".ds-video { display: flex; flex-direction: column; gap: 0.25rem; width: 320px; color: var(--ink, #1f2328); text-decoration: none; font-family: Jost, system-ui, sans-serif; font-size: 1.1875rem; line-height: 1.5; } .ds-thumb { position: relative; display: block; overflow: hidden; aspect-ratio: 16 / 9; background: var(--sky, #bfd9f0); border: 3px solid var(--ink, #1f2328); border-radius: 14px; } .ds-play { position: absolute; left: 1rem; bottom: 1rem; width: 3.5rem; height: 3.5rem; background: var(--pink, #e8509b); border: 3px solid var(--ink, #1f2328); border-radius: 50%; } .ds-play::after { content: ''; position: absolute; left: 1.2rem; top: 0.85rem; border-style: solid; border-width: 0.75rem 0 0.75rem 1.2rem; border-color: transparent transparent transparent #fff; } .ds-video strong { margin-top: 0.75rem; font-size: 1.375rem; font-weight: 600; } .ds-video:hover strong { text-decoration: underline; text-underline-offset: 0.15em; } .ds-video:focus-visible { outline: 3px solid var(--pink, #e8509b); outline-offset: 3px; } .ds-desc { color: var(--muted, #4a525c); }" + }, + { + "name": "Terminal", + "kind": "card", + "refersTo": "terminal", + "description": "Screen-black command block on the ink band, slate comments.", + "html": "
# JSON naming the diff images\nselfie review\n\n# after looking at them\nselfie approve <batch> --all",
+ "css": ".ds-terminal { margin: 0; padding: 1.25rem 1.5rem; overflow-x: auto; background: #0f0f11; color: #fff; border: 1px solid rgb(255 255 255 / 0.14); border-radius: 14px; font: 1.125rem/1.55 ui-monospace, SFMono-Regular, Menlo, monospace; } .ds-terminal:focus-visible { outline: 3px solid var(--pink, #e8509b); outline-offset: 3px; } .ds-c { color: #a9b4c0; }"
+ },
+ {
+ "name": "Shutter",
+ "kind": "custom",
+ "refersTo": "shutter",
+ "description": "The camera shutter: a white ringed circle that is a real link, with camera-yellow mode row; focus in annotation hot pink.",
+ "html": "this changed