Skip to content

Anti-AI-slop design skill for Claude Code, Cursor, and Codex.

CSS

Sticky theme banner + per-theme component archetype swap; Tier 1 skill gates

Youssef0d7c162af191
diff --git a/site/css/components.css b/site/css/components.css
index 662304e..f0457ed 100644
--- a/site/css/components.css
+++ b/site/css/components.css
@@ -23,15 +23,21 @@
color: var(--color-accent);
}
-/* — Theme picker (fixed bottom-left chip + upward popover) ————— */
-.themer {
- position: fixed;
- left: max(1rem, env(safe-area-inset-left));
- bottom: max(1rem, env(safe-area-inset-bottom));
+/* — Banner (sticky top, thin, theme picker inline) ————————— */
+.banner {
+ position: sticky;
+ top: 0;
z-index: var(--z-sticky);
- display: inline-flex;
+ display: grid;
+ grid-template-columns: auto 1fr auto;
align-items: center;
- gap: 0.5rem;
+ gap: var(--space-lg);
+ padding: 0 var(--page-gutter);
+ height: 44px;
+ background: color-mix(in oklch, var(--color-paper) 88%, transparent);
+ backdrop-filter: blur(14px) saturate(1.2);
+ -webkit-backdrop-filter: blur(14px) saturate(1.2);
+ border-block-end: var(--rule-hair) solid var(--color-rule);
font-family: var(--font-label);
font-size: 0.6875rem;
letter-spacing: var(--tracking-label);
@@ -39,237 +45,166 @@
color: var(--color-ink);
}
-.themer__trigger {
+.banner__mark {
display: inline-flex;
- align-items: center;
+ align-items: baseline;
gap: 0.55rem;
- padding: 0.55rem 0.85rem 0.55rem 0.6rem;
- background: var(--color-paper);
- border: var(--rule-hair) solid var(--color-rule-2);
+ text-decoration: none;
color: var(--color-ink);
- font: inherit;
- letter-spacing: 0.14em;
- cursor: pointer;
- min-height: 36px;
- /* explicit transitions, not transition-all */
- transition: background-color var(--dur-micro) var(--ease-out),
- border-color var(--dur-micro) var(--ease-out),
- color var(--dur-micro) var(--ease-out);
- box-shadow: 0 1px 2px oklch(20% 0.02 60 / 0.05),
- 0 8px 24px -8px oklch(20% 0.02 60 / 0.10);
-}
-
-@media (hover: hover) and (pointer: fine) {
- .themer__trigger:hover { border-color: var(--color-ink); }
}
-.themer__trigger:focus-visible {
- outline: 2px solid var(--color-focus);
- outline-offset: 2px;
-}
-
-/* Tiny accent swatch on the trigger — confirms current theme at a glance */
-.themer__trigger-swatch {
- width: 0.55rem;
- height: 0.55rem;
- background: var(--color-accent);
- display: inline-block;
- border-radius: 50%;
- flex-shrink: 0;
-}
-
-.themer__trigger-label {
- color: var(--color-muted);
-}
-
-.themer__trigger-current {
- color: var(--color-ink);
+.banner__name {
font-weight: 500;
+ letter-spacing: 0.22em;
}
-.themer__trigger-caret {
- width: 0.4em;
- height: 0.4em;
- border-right: 1.5px solid currentColor;
- border-bottom: 1.5px solid currentColor;
- transform: rotate(-135deg) translate(-1px, 1px); /* points up — popover opens up */
- transition: transform var(--dur-short) var(--ease-out);
-}
-
-.themer[aria-expanded="true"] .themer__trigger-caret {
- transform: rotate(45deg) translate(-2px, -1px); /* points down when open */
-}
-
-/* Keyboard-shortcut hint — delay-reveals on hover, instant on focus */
-.themer__kbd {
- display: inline-flex;
- align-items: center;
- justify-content: center;
- padding: 0.15rem 0.45rem;
- font-family: var(--font-label);
+.banner__ver {
font-size: 0.625rem;
- letter-spacing: 0.08em;
color: var(--color-muted);
- background: var(--color-paper-2);
- border: var(--rule-hair) solid var(--color-rule);
- opacity: 0;
- transform: translateX(-4px);
- pointer-events: none;
- min-height: 28px;
- /* hover delay: 1.2s before reveal */
- transition: opacity 180ms var(--ease-out) 1.2s,
- transform 180ms var(--ease-out) 1.2s;
+ letter-spacing: 0.14em;
}
-.themer__kbd::before {
- content: "press ";
- margin-right: 0.35em;
- text-transform: uppercase;
+/* The active theme name — the centre marker. Lives in the banner so the
+ page restructure registers as a deliberate event, not a passive repaint. */
+.banner__center {
+ justify-self: center;
+ font-family: var(--font-display);
+ font-weight: var(--display-weight, 400);
+ font-style: var(--display-style, normal);
+ font-size: var(--text-md);
+ letter-spacing: 0.04em;
+ text-transform: none;
+ color: var(--color-ink);
+ font-optical-sizing: auto;
+ transition: opacity var(--dur-short) var(--ease-out);
}
-.themer__trigger:hover ~ .themer__kbd {
- opacity: 1;
- transform: none;
+[data-theme="manifesto"] .banner__center,
+[data-theme="brutal"] .banner__center,
+[data-theme="sport"] .banner__center {
+ text-transform: uppercase;
+ letter-spacing: -0.01em;
}
-.themer__trigger:focus-visible ~ .themer__kbd,
-.themer[aria-expanded="true"] .themer__kbd {
- opacity: 1;
- transform: none;
- /* no delay on focus or open */
- transition: opacity 180ms var(--ease-out),
- transform 180ms var(--ease-out);
+[data-theme="terminal"] .banner__center::before {
+ content: "$ ";
+ color: var(--color-accent);
}
-.themer__kbd-key {
- font-weight: 500;
- color: var(--color-ink);
+[data-theme="terminal"] .banner__center {
+ font-family: var(--font-mono);
}
-@media (max-width: 40rem) {
- .themer__kbd { display: none; }
- .themer__trigger { padding-block: 0.6rem; }
+.banner__picker {
+ display: inline-flex;
+ align-items: center;
+ gap: 0.4rem;
}
-@media (prefers-reduced-motion: reduce) {
- .themer__kbd { transition-duration: 0.01ms; transition-delay: 0.01ms; }
+.banner__dot {
+ appearance: none;
+ width: 16px;
+ height: 16px;
+ padding: 0;
+ background: var(--dot, var(--color-paper));
+ border: 1px solid var(--color-rule-2);
+ border-radius: 4px;
+ cursor: pointer;
+ position: relative;
+ transition: transform 100ms var(--ease-out),
+ border-color var(--dur-micro) var(--ease-out),
+ box-shadow var(--dur-micro) var(--ease-out);
}
-/* Popover panel — opens upward from the chip */
-.themer__panel {
+.banner__dot::after {
+ content: "";
position: absolute;
- bottom: calc(100% + 0.5rem);
- left: 0;
- transform: translateY(4px);
- width: min(40rem, calc(100vw - 2rem));
- max-height: calc(100dvh - 6rem);
- overflow-y: auto;
- background: var(--color-paper);
- border: var(--rule-hair) solid var(--color-rule-2);
- padding: var(--space-lg);
- display: grid;
- grid-template-columns: repeat(4, 1fr);
- gap: var(--space-lg);
- opacity: 0;
- pointer-events: none;
- box-shadow: 0 24px 60px -20px oklch(20% 0.02 60 / 0.18),
- 0 0 0 1px oklch(20% 0.02 60 / 0.04);
- transition: opacity var(--dur-short) var(--ease-out),
- transform var(--dur-short) var(--ease-out);
-}
-
-.themer[aria-expanded="true"] .themer__panel {
- opacity: 1;
- pointer-events: auto;
- transform: translateY(0);
+ inset: 3px;
+ background: var(--dot-edge, transparent);
+ border-radius: 2px;
+ opacity: 0.85;
}
-@media (max-width: 60rem) {
- .themer__panel {
- grid-template-columns: repeat(2, 1fr);
- width: min(26rem, calc(100vw - 2rem));
+@media (hover: hover) and (pointer: fine) {
+ .banner__dot:hover {
+ transform: translateY(-1px);
+ border-color: var(--color-ink);
}
}
-@media (max-width: 36rem) {
- .themer__panel {
- grid-template-columns: 1fr 1fr;
- /* anchor to viewport edges so it doesn't clip on small screens */
- left: 0;
- right: auto;
- width: calc(100vw - 2rem);
- max-width: 26rem;
- padding: var(--space-md);
- gap: var(--space-md);
- }
+.banner__dot:focus-visible {
+ outline: 2px solid var(--color-focus);
+ outline-offset: 2px;
}
-.themer__group {
- display: grid;
- gap: var(--space-xs);
+.banner__dot[aria-pressed="true"] {
+ border-color: var(--color-ink);
+ box-shadow: 0 0 0 2px var(--color-paper), 0 0 0 3px var(--color-ink);
}
-.themer__group-label {
- font-family: var(--font-label);
- font-size: 0.625rem;
- letter-spacing: 0.18em;
- text-transform: uppercase;
- color: var(--color-muted);
- padding-bottom: 0.4rem;
- border-bottom: var(--rule-hair) solid var(--color-rule);
+.banner__sep {
+ width: 1px;
+ height: 14px;
+ background: var(--color-rule);
+ margin-inline: 0.25rem;
}
-.themer__btn {
- font: inherit;
- font-family: var(--font-label);
- display: grid;
- grid-template-columns: 1fr auto;
+.banner__random {
+ appearance: none;
+ display: inline-flex;
align-items: center;
- gap: 0.5rem;
- padding: 0.5rem 0.55rem;
+ justify-content: center;
+ width: 24px;
+ height: 24px;
+ padding: 0;
background: transparent;
- border: 0;
+ border: 1px solid var(--color-rule);
+ color: var(--color-muted);
cursor: pointer;
- text-align: left;
- color: var(--color-neutral);
- letter-spacing: 0.10em;
- text-transform: uppercase;
- font-size: 0.6875rem;
- min-height: 32px;
+ transition: color var(--dur-micro) var(--ease-out),
+ border-color var(--dur-micro) var(--ease-out),
+ transform 80ms var(--ease-out);
}
-.themer__btn:hover { color: var(--color-ink); background: var(--color-paper-2); }
-
-.themer__btn:focus-visible {
- outline: 2px solid var(--color-focus);
- outline-offset: -2px;
+@media (hover: hover) and (pointer: fine) {
+ .banner__random:hover { color: var(--color-ink); border-color: var(--color-ink); }
}
-.themer__btn[aria-pressed="true"] {
- color: var(--color-ink);
- background: var(--color-paper-2);
- position: relative;
-}
+.banner__random:active { transform: rotate(180deg); transition-duration: 220ms; }
-.themer__btn[aria-pressed="true"]::before {
- content: "";
- position: absolute;
- left: 0;
- top: 0.5rem;
- bottom: 0.5rem;
- width: 2px;
- background: var(--color-accent);
+.banner__random:focus-visible {
+ outline: 2px solid var(--color-focus);
+ outline-offset: 2px;
}
-.themer__swatches {
+.banner__kbd {
display: inline-flex;
- gap: 2px;
+ align-items: center;
+ justify-content: center;
+ margin-inline-start: 0.25rem;
+ padding: 0.1rem 0.4rem;
+ font-family: var(--font-label);
+ font-size: 0.625rem;
+ letter-spacing: 0.08em;
+ color: var(--color-muted);
+ border: 1px solid var(--color-rule);
+ border-radius: 3px;
+ min-width: 18px;
+ min-height: 18px;
+}
+
+@media (max-width: 60rem) {
+ .banner { grid-template-columns: auto 1fr auto; gap: var(--space-md); }
+ .banner__center { font-size: var(--text-sm); }
+ .banner__kbd { display: none; }
}
-.themer__swatch {
- width: 0.55rem;
- height: 0.55rem;
- border-radius: 50%;
+@media (max-width: 44rem) {
+ .banner__ver { display: none; }
+ .banner__center { display: none; }
+ .banner__picker { gap: 0.3rem; }
+ .banner__dot { width: 14px; height: 14px; }
+ .banner__sep { display: none; }
}
/* — Section label (01 / FOUNDATIONS) —————————————————— */
@@ -806,3 +741,470 @@
animation-duration: 280ms;
animation-timing-function: var(--ease-out);
}
+
+/* ───────────── HERO ARCHETYPES ─────────────
+ The hero slot picks one shape per theme, from the cookbook.
+ Each archetype is a different fingerprint — not a re-skin. */
+
+.hero { display: grid; }
+
+.hero__eyebrow {
+ display: inline-flex;
+ align-items: center;
+ gap: 0.6rem;
+ font-family: var(--font-label);
+ font-size: var(--text-xs);
+ letter-spacing: var(--tracking-label);
+ text-transform: uppercase;
+ color: var(--color-muted);
+ margin-bottom: var(--space-lg);
+}
+
+.hero__eyebrow .mark {
+ width: 6px; height: 6px;
+ background: var(--color-accent);
+ display: inline-block;
+}
+
+.hero__display {
+ font-family: var(--font-display);
+ font-weight: var(--display-weight, 400);
+ font-style: var(--display-style, normal);
+ font-size: var(--text-display);
+ line-height: var(--lh-tight);
+ letter-spacing: var(--tracking-display);
+ color: var(--color-ink);
+ font-optical-sizing: auto;
+ margin: 0;
+}
+
+.hero__display--small {
+ font-size: var(--text-display-s);
+}
+
+.hero__lede {
+ font-family: var(--font-serif);
+ font-style: italic;
+ font-size: var(--text-md);
+ line-height: var(--lh-normal);
+ color: var(--color-ink-2);
+ max-width: 56ch;
+ margin-block: var(--space-lg) 0;
+}
+
+[data-theme="brutal"] .hero__lede,
+[data-theme="manifesto"] .hero__lede,
+[data-theme="terminal"] .hero__lede,
+[data-theme="sport"] .hero__lede,
+[data-theme="almanac"] .hero__lede {
+ font-style: normal;
+ font-family: var(--font-body);
+}
+
+[data-theme="manifesto"] .hero__display,
+[data-theme="brutal"] .hero__display,
+[data-theme="sport"] .hero__display {
+ text-transform: uppercase;
+}
+
+.hero__link {
+ margin-top: var(--space-lg);
+ display: inline-block;
+ font-family: var(--font-label);
+ font-size: var(--text-sm);
+ letter-spacing: var(--tracking-label);
+ text-transform: uppercase;
+}
+
+/* H1 — Marquee. Display fills the fold, install code below. */
+.hero--marquee {
+ padding-block: var(--space-2xl) var(--space-xl);
+ gap: var(--space-lg);
+}
+
+.hero--marquee .hero__display {
+ max-width: 18ch;
+}
+
+.hero--marquee .hero__cta {
+ margin-top: var(--space-xl);
+ display: grid;
+ gap: var(--space-sm);
+ max-width: 30rem;
+}
+
+.hero--marquee .hero__cta .label {
+ font-family: var(--font-label);
+ font-size: var(--text-xs);
+ letter-spacing: var(--tracking-label);
+ text-transform: uppercase;
+ color: var(--color-muted);
+}
+
+/* H2 — Split Diptych. Title left, proof right. */
+.hero--split {
+ grid-template-columns: 7fr 5fr;
+ gap: var(--space-2xl);
+ padding-block: var(--space-2xl) var(--space-xl);
+ align-items: end;
+}
+
+@media (max-width: 60rem) {
+ .hero--split { grid-template-columns: 1fr; gap: var(--space-xl); align-items: start; }
+}
+
+.hero--split .hero__col { display: grid; gap: 0; }
+
+.hero--split .hero__proof {
+ display: grid;
+ gap: var(--space-xs);
+ padding-block-start: var(--space-md);
+ border-block-start: var(--rule-hair) solid var(--color-rule);
+}
+
+.hero--split .hero__proof .label {
+ font-family: var(--font-label);
+ font-size: var(--text-xs);
+ letter-spacing: var(--tracking-label);
+ text-transform: uppercase;
+ color: var(--color-muted);
+ margin-bottom: var(--space-xs);
+}
+
+.hero__proof-line {
+ font-family: var(--font-body);
+ font-size: var(--text-sm);
+ color: var(--color-ink-2);
+ line-height: var(--lh-snug);
+ font-variant-numeric: tabular-nums;
+}
+
+.hero--split .hero__proof a { margin-top: var(--space-sm); }
+
+/* H3 — Stat-Led. Giant number + qualifier. */
+.hero--stat {
+ padding-block: var(--space-2xl) var(--space-xl);
+ gap: 0;
+}
+
+.hero__stat {
+ font-family: var(--font-display);
+ font-weight: var(--display-weight, 400);
+ font-style: var(--display-style, normal);
+ font-size: clamp(7rem, 22vw, 16rem);
+ line-height: 0.85;
+ letter-spacing: -0.04em;
+ color: var(--color-ink);
+ font-optical-sizing: auto;
+ display: block;
+ margin-block: var(--space-md) 0;
+}
+
+.hero__qualifier {
+ font-family: var(--font-display);
+ font-weight: var(--display-weight, 400);
+ font-style: var(--display-style, normal);
+ font-size: var(--text-2xl);
+ letter-spacing: var(--tracking-display);
+ color: var(--color-ink);
+ margin-block: var(--space-md) 0;
+ font-optical-sizing: auto;
+}
+
+[data-theme="manifesto"] .hero__stat,
+[data-theme="sport"] .hero__stat {
+ color: var(--color-accent);
+}
+
+/* H4 — Quote-Led. Pull quote in italic display. */
+.hero--quote {
+ padding-block: var(--space-2xl) var(--space-xl);
+ max-width: 56rem;
+}
+
+.hero__quote {
+ margin: 0;
+ padding: 0;
+}
+
+.hero__quote p {
+ font-family: var(--font-serif);
+ font-style: italic;
+ font-weight: 400;
+ font-size: clamp(2.25rem, 4vw + 1rem, 4.25rem);
+ line-height: 1.08;
+ letter-spacing: -0.015em;
+ color: var(--color-ink);
+ margin: 0;
+}
+
+.hero__attrib {
+ margin-block-start: var(--space-lg);
+ font-family: var(--font-label);
+ font-size: var(--text-xs);
+ letter-spacing: var(--tracking-label);
+ text-transform: uppercase;
+ color: var(--color-muted);
+}
+
+[data-theme="brutal"] .hero__quote p,
+[data-theme="manifesto"] .hero__quote p,
+[data-theme="terminal"] .hero__quote p,
+[data-theme="sport"] .hero__quote p,
+[data-theme="almanac"] .hero__quote p {
+ font-style: normal;
+ font-family: var(--font-display);
+}
+
+/* H5 — Letter. First-person greeting, paragraph body, signoff. */
+.hero--letter {
+ padding-block: var(--space-2xl) var(--space-xl);
+ max-width: 52rem;
+ gap: 0;
+}
+
+.hero__salutation {
+ font-family: var(--font-display);
+ font-weight: var(--display-weight, 400);
+ font-style: italic;
+ font-size: clamp(2rem, 3vw + 1rem, 3.25rem);
+ line-height: 1.15;
+ letter-spacing: -0.01em;
+ color: var(--color-ink);
+ margin-block: var(--space-md) var(--space-lg);
+ font-optical-sizing: auto;
+}
+
+.hero__letter-body {
+ font-family: var(--font-serif);
+ font-size: var(--text-md);
+ line-height: var(--lh-relaxed);
+ color: var(--color-ink-2);
+ max-width: 60ch;
+ margin: 0;
+}
+
+[data-theme="brutal"] .hero__letter-body,
+[data-theme="terminal"] .hero__letter-body,
+[data-theme="sport"] .hero__letter-body,
+[data-theme="almanac"] .hero__letter-body {
+ font-family: var(--font-body);
+}
+
+.hero__signoff {
+ margin-block: var(--space-xl) 0;
+ font-family: var(--font-serif);
+ font-size: var(--text-md);
+ font-style: italic;
+ color: var(--color-ink-2);
+ line-height: var(--lh-snug);
+}
+
+.hero__sign {
+ font-style: normal;
+ font-family: var(--font-display);
+ color: var(--color-ink);
+ letter-spacing: var(--tracking-display);
+}
+
+/* H6 — Photographic. Image area + small caption + text below. */
+.hero--photo {
+ padding-block: var(--space-xl) var(--space-xl);
+ gap: var(--space-xl);
+ grid-template-columns: 1fr;
+}
+
+.hero__photo {
+ position: relative;
+ aspect-ratio: 16 / 7;
+ background: var(--color-paper-2);
+ border: var(--rule-hair) solid var(--color-rule);
+ overflow: hidden;
+}
+
+.hero__photo-grid {
+ position: absolute;
+ inset: 0;
+ display: grid;
+ grid-template-columns: repeat(3, 1fr);
+ grid-template-rows: repeat(3, 1fr);
+ gap: 1px;
+ background: var(--color-rule);
+}
+
+.hero__photo-grid > span {
+ background: linear-gradient(135deg,
+ color-mix(in oklch, var(--color-paper-3) 80%, var(--color-accent) 5%),
+ color-mix(in oklch, var(--color-neutral) 30%, var(--color-paper) 70%));
+}
+
+.hero__photo-grid > span:nth-child(2n) { background: linear-gradient(180deg, var(--color-paper-3), var(--color-paper-2)); }
+.hero__photo-grid > span:nth-child(3n) { background: linear-gradient(45deg, var(--color-paper-2), var(--color-paper-3)); }
+.hero__photo-grid > span:nth-child(5n) { background: linear-gradient(90deg, var(--color-paper-3), color-mix(in oklch, var(--color-accent) 10%, var(--color-paper))); }
+.hero__photo-grid > span:nth-child(7n) { background: var(--color-neutral); }
+
+.hero__photo-caption {
+ position: absolute;
+ left: var(--space-md);
+ bottom: var(--space-md);
+ font-family: var(--font-label);
+ font-size: var(--text-xs);
+ letter-spacing: var(--tracking-label);
+ text-transform: uppercase;
+ color: var(--color-paper);
+ background: color-mix(in oklch, var(--color-ink) 78%, transparent);
+ padding: 0.35rem 0.65rem;
+}
+
+.hero__photo-text { display: grid; gap: 0; }
+
+/* ───────────── FOOTER ARCHETYPES ───────────── */
+
+.foot { display: grid; gap: var(--space-md); padding-block: var(--space-2xl) var(--space-xl); border-block-start: var(--rule-hair) solid var(--color-rule); }
+
+/* Ft1 — Masthead. Wordmark + tagline + links + powered. */
+.foot--masthead {
+ grid-template-columns: 1fr;
+ gap: var(--space-md);
+ align-items: start;
+}
+
+.foot__wordmark {
+ font-family: var(--font-display);
+ font-weight: var(--display-weight, 400);
+ font-style: var(--display-style, normal);
+ font-size: var(--text-3xl);
+ letter-spacing: var(--tracking-display);
+ color: var(--color-ink);
+ font-optical-sizing: auto;
+ line-height: 1;
+}
+
+[data-theme="manifesto"] .foot__wordmark,
+[data-theme="brutal"] .foot__wordmark,
+[data-theme="sport"] .foot__wordmark { text-transform: uppercase; }
+
+.foot__tagline {
+ font-family: var(--font-serif);
+ font-style: italic;
+ font-size: var(--text-md);
+ color: var(--color-ink-2);
+ max-width: 50ch;
+ margin: 0;
+ line-height: var(--lh-snug);
+}
+
+[data-theme="brutal"] .foot__tagline,
+[data-theme="manifesto"] .foot__tagline,
+[data-theme="terminal"] .foot__tagline,
+[data-theme="sport"] .foot__tagline,
+[data-theme="almanac"] .foot__tagline {
+ font-style: normal;
+ font-family: var(--font-body);
+}
+
+.foot__links {
+ display: flex;
+ flex-wrap: wrap;
+ gap: var(--space-md);
+ margin-block-start: var(--space-md);
+ font-family: var(--font-label);
+ font-size: var(--text-sm);
+ letter-spacing: 0.04em;
+}
+
+.foot__powered {
+ margin-block-start: var(--space-lg);
+ font-family: var(--font-label);
+ font-size: var(--text-xs);
+ letter-spacing: var(--tracking-label);
+ text-transform: uppercase;
+ color: var(--color-muted);
+}
+
+.foot__powered-mark {
+ color: var(--color-ink);
+ font-weight: 500;
+}
+
+/* Ft2 — Inline. Single dense line. */
+.foot--inline {
+ grid-template-columns: 1fr;
+ display: flex;
+ flex-wrap: wrap;
+ align-items: center;
+ gap: var(--space-md);
+ font-family: var(--font-label);
+ font-size: var(--text-xs);
+ letter-spacing: var(--tracking-label);
+ text-transform: uppercase;
+ color: var(--color-muted);
+}
+
+.foot__wordmark-small {
+ color: var(--color-ink);
+ font-weight: 500;
+ letter-spacing: 0.22em;
+}
+
+.foot__sep {
+ width: 1px; height: 12px; background: var(--color-rule-2);
+}
+
+/* Ft3 — Index columns. */
+.foot--index {
+ grid-template-columns: repeat(4, 1fr);
+ gap: var(--space-xl);
+}
+
+@media (max-width: 60rem) {
+ .foot--index { grid-template-columns: repeat(2, 1fr); }
+}
+
+.foot__col-head {
+ font-family: var(--font-label);
+ font-size: var(--text-xs);
+ letter-spacing: var(--tracking-label);
+ text-transform: uppercase;
+ color: var(--color-muted);
+ margin-block-end: var(--space-sm);
+ padding-block-end: var(--space-xs);
+ border-block-end: var(--rule-hair) solid var(--color-rule);
+}
+
+.foot--index ul {
+ list-style: none;
+ margin: 0;
+ padding: 0;
+ display: grid;
+ gap: var(--space-2xs);
+ font-family: var(--font-body);
+ font-size: var(--text-sm);
+ color: var(--color-ink-2);
+}
+
+/* Ft4 — Dense colophon (monospace). */
+.foot--dense {
+ font-family: var(--font-mono);
+ font-size: var(--text-xs);
+ line-height: 1.7;
+ color: var(--color-ink-2);
+ white-space: pre-wrap;
+ margin: 0;
+ padding-block: var(--space-md);
+}
+
+/* ───────────── SLOT REVEALS ─────────────
+ The slot fades when its archetype is replaced — supplements the
+ View Transition and gives a graceful enter on first paint. */
+
+.slot[data-populating] > * {
+ animation: slot-in calc(var(--dur-long) * 0.7) var(--ease-out) forwards;
+ opacity: 0;
+}
+
+@keyframes slot-in { to { opacity: 1; } }
+
+@media (prefers-reduced-motion: reduce) {
+ .slot[data-populating] > * { animation: none; opacity: 1; }
+}
diff --git a/site/css/sections.css b/site/css/sections.css
index 583853d..53c40f3 100644
--- a/site/css/sections.css
+++ b/site/css/sections.css
@@ -6,28 +6,16 @@
margin-inline: auto;
display: grid;
gap: var(--section-gap);
- padding-block: var(--space-lg) var(--space-4xl);
+ padding-block: var(--space-2xl) var(--space-4xl);
+ padding-inline: var(--page-gutter);
}
-/* — Nav ————————————————————————————————————————————— */
-.nav {
- display: flex;
- align-items: center;
- justify-content: space-between;
- gap: var(--space-lg);
- padding-block: var(--space-md);
-}
-
-.nav__meta {
- font-family: var(--font-label);
- font-size: var(--text-xs);
- color: var(--color-muted);
- letter-spacing: var(--tracking-label);
- text-transform: uppercase;
+/* — Slot — a region whose component archetype swaps per theme ————— */
+.slot {
+ display: block;
+ min-height: 1px; /* keeps reveal animation valid before populated */
}
-.nav__meta a { color: var(--color-ink); }
-
/* — Section container ——————————————————————————————— */
.section {
display: grid;
diff --git a/site/index.html b/site/index.html
index 64a94ab..1f815f9 100644
--- a/site/index.html
+++ b/site/index.html
@@ -21,48 +21,60 @@
<link rel="stylesheet" href="css/sections.css" />
<script>
- // Load stored theme before paint to avoid flash
+ // Load theme before paint to avoid flash. Order: ?theme= → localStorage → default.
try {
- const t = localStorage.getItem("hallmark-theme");
+ const url = new URL(window.location.href);
+ const q = url.searchParams.get("theme");
+ const t = q || localStorage.getItem("hallmark-theme");
if (t) document.documentElement.dataset.theme = t;
} catch (e) {}
</script>
</head>
<body>
+ <!-- BANNER — sticky top, thin, holds the theme picker -->
+ <header class="banner" role="banner">
+ <a class="banner__mark" href="#top" aria-label="Hallmark — top of page">
+ <span class="banner__name">Hallmark</span>
+ <span class="banner__ver">v0.2</span>
+ </a>
+
+ <span class="banner__center" data-theme-current>Specimen</span>
+
+ <div class="banner__picker" role="radiogroup" aria-label="Theme">
+ <button class="banner__dot" type="button" data-theme-btn="specimen" aria-label="Specimen" style="--dot: oklch(96% 0.018 80); --dot-edge: oklch(70% 0.04 75);"></button>
+ <button class="banner__dot" type="button" data-theme-btn="newsprint" aria-label="Newsprint" style="--dot: oklch(92% 0.045 50); --dot-edge: oklch(32% 0.10 28);"></button>
+ <button class="banner__dot" type="button" data-theme-btn="atelier" aria-label="Atelier" style="--dot: oklch(94% 0.005 60); --dot-edge: oklch(45% 0.13 60);"></button>
+ <button class="banner__dot" type="button" data-theme-btn="garden" aria-label="Garden" style="--dot: oklch(95% 0.030 130); --dot-edge: oklch(54% 0.16 14);"></button>
+ <button class="banner__dot" type="button" data-theme-btn="salon" aria-label="Salon" style="--dot: oklch(94% 0.030 65); --dot-edge: oklch(40% 0.085 50);"></button>
+ <button class="banner__dot" type="button" data-theme-btn="linen" aria-label="Linen" style="--dot: oklch(89% 0.022 95); --dot-edge: oklch(46% 0.06 95);"></button>
+ <button class="banner__dot" type="button" data-theme-btn="almanac" aria-label="Almanac" style="--dot: oklch(94% 0.008 245); --dot-edge: oklch(38% 0.135 250);"></button>
+ <button class="banner__dot" type="button" data-theme-btn="midnight" aria-label="Midnight" style="--dot: oklch(15% 0.022 250); --dot-edge: oklch(72% 0.16 220);"></button>
+ <button class="banner__dot" type="button" data-theme-btn="terminal" aria-label="Terminal" style="--dot: oklch(11% 0.018 145); --dot-edge: oklch(78% 0.19 138);"></button>
+ <button class="banner__dot" type="button" data-theme-btn="brutal" aria-label="Brutal" style="--dot: oklch(98% 0.001 0); --dot-edge: oklch(60% 0.21 27);"></button>
+ <button class="banner__dot" type="button" data-theme-btn="manifesto" aria-label="Manifesto" style="--dot: oklch(10% 0.005 60); --dot-edge: oklch(60% 0.22 27);"></button>
+ <button class="banner__dot" type="button" data-theme-btn="sport" aria-label="Sport" style="--dot: oklch(98% 0.003 250); --dot-edge: oklch(58% 0.190 35);"></button>
+
+ <span class="banner__sep" aria-hidden="true"></span>
+
+ <button class="banner__random" type="button" aria-label="Random theme" title="Random (R)">
+ <svg viewBox="0 0 16 16" width="14" height="14" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+ <path d="M2 4 L7 4 L13 12 L14 12" />
+ <path d="M14 12 L12 10 M14 12 L12 14" />
+ <path d="M2 12 L7 12 L9 9.5" />
+ <path d="M11 6.5 L13 4 L14 4" />
+ <path d="M14 4 L12 2 M14 4 L12 6" />
+ </svg>
+ </button>
+
+ <span class="banner__kbd" aria-hidden="true">T</span>
+ </div>
+ </header>
+
<main class="page">
- <!-- NAV -->
- <nav class="nav" aria-label="Primary">
- <a href="#top" class="wordmark">Hallmark</a>
- <div class="nav__meta">
- v0.1 &nbsp;·&nbsp; <a href="#install" class="link">Install</a>
- </div>
- </nav>
-
- <!-- 01 · OPENING -->
- <header class="opening reveal" style="--i:0" id="top">
- <div>
- <p class="opening__eyebrow">
- <span class="mark" aria-hidden="true"></span>
- A design skill · Powered by Together AI
- </p>
- <h1 class="opening__title">
- Designs that refuse to look <em>AI-generated.</em>
- </h1>
- <p class="opening__sub">
- Hallmark is a skill for Claude Code, Cursor, and Codex. It encodes the anti-slop consensus — typography, colour, layout, motion, interaction — into one holistic ruleset your AI assistant will actually follow.
- </p>
- </div>
- <aside class="opening__aside">
- <div class="opening__rule" aria-hidden="true"></div>
- <div class="opening__cta">
- <p class="label">01 &nbsp;⁄&nbsp; Install</p>
- <pre class="code" data-copy-source><span class="prompt">$</span><span data-copy-text>npx skills add hallmark</span><button class="code__copy" type="button" data-copy-btn aria-label="Copy install command"><span class="code__copy-default">Copy</span><span class="code__copy-done">Copied</span></button></pre>
- <a href="#install" class="link">Other ways to install &rarr;</a>
- </div>
- </aside>
- </header>
+ <!-- 01 · HERO SLOT — archetype swaps per theme -->
+ <section class="slot slot--hero reveal" data-slot="hero" id="top" style="--i:0" aria-label="Opening"></section>
<!-- 02 · THE PROBLEM -->
<section class="section reveal" style="--i:1" aria-labelledby="s2">
@@ -208,7 +220,7 @@
<p class="spec__rule">Specific verbs. Three-part errors. Link text that reads alone. Proper punctuation, not straight quotes.</p>
<div class="spec__body">
<span class="serif-italic" style="font-size:var(--text-md); color:var(--color-ink-2);">
- “Save changes” beats “OK”. “View pricing plans” beats “Click here”.
+ &ldquo;Save changes&rdquo; beats &ldquo;OK&rdquo;. &ldquo;View pricing plans&rdquo; beats &ldquo;Click here&rdquo;.
</span>
</div>
</article>
@@ -380,152 +392,158 @@
</div>
</section>
- <!-- 07 · FOOTER -->
- <footer class="foot reveal" style="--i:6" role="contentinfo">
- <div class="foot__credits">
- MIT licensed. Built on the research of
- <a href="https://github.com/pbakaus/impeccable" class="link">impeccable</a>,
- <a href="https://github.com/tw93/kami" class="link">kami</a>,
- <a href="https://github.com/Leonxlnx/taste-skill" class="link">taste-skill</a>,
- and Anthropic's <a href="https://github.com/anthropics/skills" class="link">frontend-design skill</a>.
- Where rules overlapped, Hallmark adopted. Where they diverged, Hallmark picked.
- </div>
- <div class="foot__powered">
- <span class="foot__powered-mark">Powered by Together AI</span>
- </div>
- </footer>
+ <!-- 07 · FOOTER SLOT — archetype swaps per theme -->
+ <footer class="slot slot--foot reveal" data-slot="footer" style="--i:6" role="contentinfo" aria-label="Colophon"></footer>
</main>
- <!-- Theme picker — fixed bottom-left, never in the navbar. -->
- <div class="themer" aria-expanded="false">
- <button class="themer__trigger" type="button" id="themer-trigger" aria-haspopup="dialog" aria-expanded="false">
- <span class="themer__trigger-swatch" aria-hidden="true"></span>
- <span class="themer__trigger-label">Theme&nbsp;·&nbsp;</span>
- <span class="themer__trigger-current" data-theme-current>Specimen</span>
- <span class="themer__trigger-caret" aria-hidden="true"></span>
- </button>
-
- <span class="themer__kbd" aria-hidden="true">
- <span class="themer__kbd-key">T</span>
- </span>
-
- <div class="themer__panel" id="themer-panel" role="dialog" aria-label="Choose a theme">
-
- <div class="themer__group">
- <p class="themer__group-label">Editorial</p>
- <button class="themer__btn" type="button" data-theme-btn="specimen" aria-pressed="true">
- <span>Specimen</span>
- <span class="themer__swatches" aria-hidden="true">
- <span class="themer__swatch" style="background: oklch(96% 0.018 80)"></span>
- <span class="themer__swatch" style="background: oklch(18% 0.014 60)"></span>
- <span class="themer__swatch" style="background: #FC4C02"></span>
- </span>
- </button>
- <button class="themer__btn" type="button" data-theme-btn="newsprint" aria-pressed="false">
- <span>Newsprint</span>
- <span class="themer__swatches" aria-hidden="true">
- <span class="themer__swatch" style="background: oklch(92% 0.045 50)"></span>
- <span class="themer__swatch" style="background: oklch(15% 0.030 25)"></span>
- <span class="themer__swatch" style="background: oklch(32% 0.10 28)"></span>
- </span>
- </button>
- <button class="themer__btn" type="button" data-theme-btn="atelier" aria-pressed="false">
- <span>Atelier</span>
- <span class="themer__swatches" aria-hidden="true">
- <span class="themer__swatch" style="background: oklch(94% 0.005 60)"></span>
- <span class="themer__swatch" style="background: oklch(12% 0.024 40)"></span>
- <span class="themer__swatch" style="background: oklch(45% 0.13 60)"></span>
- </span>
- </button>
- </div>
+ <!-- ─────────── HERO ARCHETYPES ─────────── -->
- <div class="themer__group">
- <p class="themer__group-label">Soft</p>
- <button class="themer__btn" type="button" data-theme-btn="garden" aria-pressed="false">
- <span>Garden</span>
- <span class="themer__swatches" aria-hidden="true">
- <span class="themer__swatch" style="background: oklch(95% 0.030 130)"></span>
- <span class="themer__swatch" style="background: oklch(22% 0.060 160)"></span>
- <span class="themer__swatch" style="background: #B6485E"></span>
- </span>
- </button>
- <button class="themer__btn" type="button" data-theme-btn="salon" aria-pressed="false">
- <span>Salon</span>
- <span class="themer__swatches" aria-hidden="true">
- <span class="themer__swatch" style="background: oklch(94% 0.030 65)"></span>
- <span class="themer__swatch" style="background: oklch(22% 0.030 38)"></span>
- <span class="themer__swatch" style="background: oklch(40% 0.085 50)"></span>
- </span>
- </button>
- <button class="themer__btn" type="button" data-theme-btn="linen" aria-pressed="false">
- <span>Linen</span>
- <span class="themer__swatches" aria-hidden="true">
- <span class="themer__swatch" style="background: oklch(89% 0.022 95)"></span>
- <span class="themer__swatch" style="background: oklch(22% 0.025 90)"></span>
- <span class="themer__swatch" style="background: oklch(46% 0.06 95)"></span>
- </span>
- </button>
+ <template id="hero-marquee">
+ <div class="hero hero--marquee">
+ <p class="hero__eyebrow"><span class="mark" aria-hidden="true"></span>{{eyebrow}}</p>
+ <h1 class="hero__display" data-text="{{title}}">{{title}}</h1>
+ <p class="hero__lede">{{lede}}</p>
+ <div class="hero__cta">
+ <p class="label">{{ctaLabel}}</p>
+ <pre class="code" data-copy-source><span class="prompt">$</span><span data-copy-text>npx skills add hallmark</span><button class="code__copy" type="button" data-copy-btn aria-label="Copy install command"><span class="code__copy-default">Copy</span><span class="code__copy-done">Copied</span></button></pre>
</div>
-
- <div class="themer__group">
- <p class="themer__group-label">Technical</p>
- <button class="themer__btn" type="button" data-theme-btn="midnight" aria-pressed="false">
- <span>Midnight</span>
- <span class="themer__swatches" aria-hidden="true">
- <span class="themer__swatch" style="background: oklch(15% 0.022 250)"></span>
- <span class="themer__swatch" style="background: oklch(95% 0.008 230)"></span>
- <span class="themer__swatch" style="background: oklch(72% 0.16 220)"></span>
- </span>
- </button>
- <button class="themer__btn" type="button" data-theme-btn="terminal" aria-pressed="false">
- <span>Terminal</span>
- <span class="themer__swatches" aria-hidden="true">
- <span class="themer__swatch" style="background: oklch(11% 0.018 145)"></span>
- <span class="themer__swatch" style="background: oklch(86% 0.16 138)"></span>
- <span class="themer__swatch" style="background: oklch(78% 0.19 138)"></span>
- </span>
- </button>
- <button class="themer__btn" type="button" data-theme-btn="almanac" aria-pressed="false">
- <span>Almanac</span>
- <span class="themer__swatches" aria-hidden="true">
- <span class="themer__swatch" style="background: oklch(94% 0.008 245)"></span>
- <span class="themer__swatch" style="background: oklch(16% 0.020 245)"></span>
- <span class="themer__swatch" style="background: oklch(38% 0.135 250)"></span>
- </span>
- </button>
+ </div>
+ </template>
+
+ <template id="hero-split">
+ <div class="hero hero--split">
+ <div class="hero__col">
+ <p class="hero__eyebrow"><span class="mark" aria-hidden="true"></span>{{eyebrow}}</p>
+ <h1 class="hero__display">{{title}}</h1>
+ <p class="hero__lede">{{lede}}</p>
</div>
-
- <div class="themer__group">
- <p class="themer__group-label">Bold</p>
- <button class="themer__btn" type="button" data-theme-btn="brutal" aria-pressed="false">
- <span>Brutal</span>
- <span class="themer__swatches" aria-hidden="true">
- <span class="themer__swatch" style="background: oklch(98% 0.001 0)"></span>
- <span class="themer__swatch" style="background: oklch(8% 0.005 0)"></span>
- <span class="themer__swatch" style="background: #E63946"></span>
- </span>
- </button>
- <button class="themer__btn" type="button" data-theme-btn="manifesto" aria-pressed="false">
- <span>Manifesto</span>
- <span class="themer__swatches" aria-hidden="true">
- <span class="themer__swatch" style="background: oklch(10% 0.005 60)"></span>
- <span class="themer__swatch" style="background: oklch(98% 0.003 90)"></span>
- <span class="themer__swatch" style="background: #E51A1A"></span>
- </span>
- </button>
- <button class="themer__btn" type="button" data-theme-btn="sport" aria-pressed="false">
- <span>Sport</span>
- <span class="themer__swatches" aria-hidden="true">
- <span class="themer__swatch" style="background: oklch(98% 0.003 250)"></span>
- <span class="themer__swatch" style="background: oklch(16% 0.080 260)"></span>
- <span class="themer__swatch" style="background: oklch(58% 0.190 35)"></span>
- </span>
- </button>
+ <aside class="hero__proof">
+ <p class="label">{{proofLabel}}</p>
+ <p class="hero__proof-line">{{proofA}}</p>
+ <p class="hero__proof-line">{{proofB}}</p>
+ <p class="hero__proof-line">{{proofC}}</p>
+ <a href="#install" class="link">{{cta}} &rarr;</a>
+ </aside>
+ </div>
+ </template>
+
+ <template id="hero-stat-led">
+ <div class="hero hero--stat">
+ <p class="hero__eyebrow"><span class="mark" aria-hidden="true"></span>{{eyebrow}}</p>
+ <span class="hero__stat tabular-nums">{{stat}}</span>
+ <p class="hero__qualifier">{{qualifier}}</p>
+ <p class="hero__lede">{{lede}}</p>
+ <a href="#install" class="link hero__link">{{cta}} &rarr;</a>
+ </div>
+ </template>
+
+ <template id="hero-quote-led">
+ <div class="hero hero--quote">
+ <p class="hero__eyebrow"><span class="mark" aria-hidden="true"></span>{{eyebrow}}</p>
+ <blockquote class="hero__quote">
+ <p>&ldquo;{{quote}}&rdquo;</p>
+ <footer class="hero__attrib">— {{attrib}}</footer>
+ </blockquote>
+ <p class="hero__lede">{{lede}}</p>
+ <a href="#install" class="link hero__link">{{cta}} &rarr;</a>
+ </div>
+ </template>
+
+ <template id="hero-letter">
+ <div class="hero hero--letter">
+ <p class="hero__eyebrow"><span class="mark" aria-hidden="true"></span>{{eyebrow}}</p>
+ <p class="hero__salutation">{{salutation}}</p>
+ <p class="hero__letter-body">{{letterBody}}</p>
+ <p class="hero__signoff">{{signoff}}<br><span class="hero__sign">— Hallmark</span></p>
+ </div>
+ </template>
+
+ <template id="hero-photographic">
+ <div class="hero hero--photo">
+ <div class="hero__photo" aria-hidden="true">
+ <div class="hero__photo-grid">
+ <span></span><span></span><span></span>
+ <span></span><span></span><span></span>
+ <span></span><span></span><span></span>
+ </div>
+ <span class="hero__photo-caption">{{captionA}} · {{captionB}}</span>
</div>
-
+ <div class="hero__photo-text">
+ <p class="hero__eyebrow"><span class="mark" aria-hidden="true"></span>{{eyebrow}}</p>
+ <h1 class="hero__display hero__display--small">{{title}}</h1>
+ <p class="hero__lede">{{lede}}</p>
+ </div>
+ </div>
+ </template>
+
+ <!-- ─────────── FOOTER ARCHETYPES ─────────── -->
+
+ <template id="footer-masthead">
+ <div class="foot foot--masthead">
+ <span class="foot__wordmark">Hallmark</span>
+ <p class="foot__tagline">{{tagline}}</p>
+ <div class="foot__links">
+ <a href="https://github.com/Luffixos/hallmark" class="link">GitHub</a>
+ <a href="https://github.com/pbakaus/impeccable" class="link">impeccable</a>
+ <a href="https://github.com/tw93/kami" class="link">kami</a>
+ <a href="https://github.com/anthropics/skills" class="link">Anthropic skills</a>
+ </div>
+ <p class="foot__powered"><span class="foot__powered-mark">Powered by Together AI</span></p>
</div>
- </div>
+ </template>
+
+ <template id="footer-inline">
+ <div class="foot foot--inline">
+ <span class="foot__wordmark-small">Hallmark</span>
+ <span class="foot__sep" aria-hidden="true"></span>
+ <span class="foot__line">{{tagline}}</span>
+ <span class="foot__sep" aria-hidden="true"></span>
+ <a href="https://github.com/Luffixos/hallmark" class="link">GitHub</a>
+ <span class="foot__sep" aria-hidden="true"></span>
+ <span class="foot__powered-mark">Powered by Together AI</span>
+ </div>
+ </template>
+
+ <template id="footer-index">
+ <div class="foot foot--index">
+ <div class="foot__col">
+ <p class="foot__col-head">Skill</p>
+ <ul>
+ <li><a href="https://github.com/Luffixos/hallmark" class="link">GitHub</a></li>
+ <li><a href="#install" class="link">Install</a></li>
+ <li><a href="#install" class="link">Roadmap</a></li>
+ </ul>
+ </div>
+ <div class="foot__col">
+ <p class="foot__col-head">Influences</p>
+ <ul>
+ <li><a href="https://github.com/pbakaus/impeccable" class="link">impeccable</a></li>
+ <li><a href="https://github.com/tw93/kami" class="link">kami</a></li>
+ <li><a href="https://github.com/anthropics/skills" class="link">frontend-design</a></li>
+ </ul>
+ </div>
+ <div class="foot__col">
+ <p class="foot__col-head">Themes</p>
+ <ul>
+ <li>12 themes</li>
+ <li>21 macrostructures</li>
+ <li>32 archetypes</li>
+ </ul>
+ </div>
+ <div class="foot__col">
+ <p class="foot__col-head">Powered</p>
+ <ul>
+ <li><span class="foot__powered-mark">Together AI</span></li>
+ <li>MIT licensed</li>
+ </ul>
+ </div>
+ </div>
+ </template>
+
+ <template id="footer-dense">
+ <pre class="foot foot--dense">{{denseColophon}}</pre>
+ </template>
<script type="module" src="js/main.js"></script>
</body>
diff --git a/site/js/main.js b/site/js/main.js
index c26f007..de2b56f 100644
--- a/site/js/main.js
+++ b/site/js/main.js
@@ -1,4 +1,5 @@
-// Hallmark — reveals + theme picker + microinteractions.
+// Hallmark — landing-page interactions.
+// Sticky banner theme picker + per-theme component archetype swap.
// Dogfoods the patterns in skill/references/microinteractions.md.
const reduced = matchMedia("(prefers-reduced-motion: reduce)").matches;
@@ -17,45 +18,12 @@ if (reduced || !("IntersectionObserver" in window)) {
}
}
},
- { threshold: 0.08, rootMargin: "0px 0px -5% 0px" }
+ { threshold: 0.05, rootMargin: "0px 0px -2% 0px" }
);
reveals.forEach((el) => io.observe(el));
}
-/* — Copy-to-clipboard (silent success, label swap pattern) ————— */
-const copyBtns = document.querySelectorAll("[data-copy-btn]");
-copyBtns.forEach((btn) => {
- btn.addEventListener("click", async () => {
- const source = btn.closest("[data-copy-source]");
- const textNode = source && source.querySelector("[data-copy-text]");
- const text = textNode ? textNode.textContent.trim() : "";
- if (!text) return;
-
- try {
- await navigator.clipboard.writeText(text);
- } catch (err) {
- // Fallback for older browsers / non-secure contexts
- const ta = document.createElement("textarea");
- ta.value = text;
- ta.setAttribute("readonly", "");
- ta.style.position = "fixed";
- ta.style.left = "-9999px";
- document.body.appendChild(ta);
- ta.select();
- try { document.execCommand("copy"); } catch (e) {}
- document.body.removeChild(ta);
- }
-
- btn.dataset.state = "copied";
- btn.setAttribute("aria-live", "polite");
- clearTimeout(btn._copyTimer);
- btn._copyTimer = setTimeout(() => {
- delete btn.dataset.state;
- }, 2200);
- });
-});
-
-/* — Theme picker ————————————————————————————————————— */
+/* — Theme registry ————————————————————————————————————— */
const THEMES = {
specimen: "Specimen",
midnight: "Midnight",
@@ -72,15 +40,386 @@ const THEMES = {
};
const STORAGE_KEY = "hallmark-theme";
+/* — Theme → archetype tuple map ——————————————————————————
+ Each theme picks one cookbook entry per slot. The point is structural
+ variety: switching themes literally rebuilds the page, not just
+ recolours it. See skill/references/component-cookbook.md. */
+const ARCHETYPES = {
+ specimen: { hero: "marquee", footer: "masthead" },
+ newsprint: { hero: "split", footer: "index" },
+ atelier: { hero: "quote-led", footer: "inline" },
+ garden: { hero: "letter", footer: "masthead" },
+ salon: { hero: "quote-led", footer: "masthead" },
+ linen: { hero: "letter", footer: "inline" },
+ almanac: { hero: "stat-led", footer: "index" },
+ midnight: { hero: "stat-led", footer: "index" },
+ terminal: { hero: "marquee", footer: "dense" },
+ brutal: { hero: "photographic", footer: "inline" },
+ manifesto: { hero: "marquee", footer: "masthead" },
+ sport: { hero: "stat-led", footer: "inline" },
+};
+
+/* — Per-theme copy fixtures —————————————————————————————
+ Distinct voice per theme so the page doesn't read like the same
+ page in different fonts. */
+const COPY = {
+ specimen: {
+ eyebrow: "A design skill · Powered by Together AI",
+ title: "Type, set with care.",
+ lede: "Hallmark is a skill for Claude Code, Cursor, and Codex. It encodes the anti-slop consensus — typography, colour, layout, motion, interaction — into one holistic ruleset your AI assistant will actually follow.",
+ ctaLabel: "01 ⁄ Install",
+ proofLabel: "Proof",
+ proofA: "21 macrostructures",
+ proofB: "32 component archetypes",
+ proofC: "29-question slop test",
+ cta: "Read the rules",
+ stat: "21",
+ qualifier: "macrostructures",
+ quote: "Two pages from two briefs feel like different sites — not colour-swaps of one template.",
+ attrib: "The rule Hallmark is built around",
+ salutation: "Dear designer,",
+ letterBody:"Every LLM has been trained on the same templates. Without a firm hand, they all emit the same page. Hallmark is the firm hand. It refuses the defaults, asks the questions that matter, and stamps the page so the next run produces something genuinely different.",
+ signoff: "With care,",
+ captionA: "Plate 01",
+ captionB: "From the working archive",
+ },
+ newsprint: {
+ eyebrow: "Volume I · Issue 02 · 28 April 2026",
+ title: "Print discipline, on screen.",
+ lede: "Twelve themes. Twenty-one named page shapes. Thirty-two component archetypes. A 29-question slop test that gates every output before it ships. Hallmark is the rulebook the LLM never read.",
+ ctaLabel: "Distribution",
+ proofLabel: "From the rule sheet",
+ proofA: "Multi-column body, justified",
+ proofB: "Hairline rules, not boxes",
+ proofC: "Outlined CTAs, never pills",
+ cta: "Read in full",
+ stat: "29",
+ qualifier: "gates",
+ quote: "We compose the page like a broadsheet. Hairlines, columns, restraint.",
+ attrib: "From the Hallmark rule sheet",
+ salutation: "Letter from the editor.",
+ letterBody:"There was a time when a printed page implied that a hand had been on it. We have tried, in this skill, to put a hand on every screen.",
+ signoff: "Yours,",
+ captionA: "Issue 02",
+ captionB: "Press run",
+ },
+ atelier: {
+ eyebrow: "An atelier note",
+ title: "A studied hand.",
+ lede: "A small, opinionated craftsmanship engine that argues with your AI assistant on your behalf — and wins.",
+ ctaLabel: "By appointment",
+ proofLabel: "Marks of the house",
+ proofA: "OKLCH-anchored palettes",
+ proofB: "Italic display, weighted rest",
+ proofC: "Negative space as divider",
+ cta: "Request the manual",
+ stat: "12",
+ qualifier: "themes",
+ quote: "Restraint, repeated, becomes a signature.",
+ attrib: "Studio note",
+ salutation: "A note from the studio.",
+ letterBody:"We do not believe in defaults. The default is the average; we are looking for the specific. Every page Hallmark touches is a small refusal of the average, in favour of a page that knows what it is.",
+ signoff: "— the studio",
+ captionA: "Workbench",
+ captionB: "12 April",
+ },
+ garden: {
+ eyebrow: "A small dispatch",
+ title: "Quietly considered.",
+ lede: "Twelve themes that disagree with each other on purpose. Pick one and the whole page changes — not the colours, the bones.",
+ ctaLabel: "Plant it",
+ proofLabel: "What grows here",
+ proofA: "Hairline rules · negative space",
+ proofB: "Italic body · serif emphasis",
+ proofC: "One accent, used sparingly",
+ cta: "Begin",
+ stat: "12",
+ qualifier: "themes in the garden",
+ quote: "A garden is not the absence of weeds. It is the presence of a plan.",
+ attrib: "Hallmark, on design",
+ salutation: "Hello,",
+ letterBody:"This skill is small. It is opinionated about a few things and quiet about the rest. We have tended it like a garden: pulling out the loud, leaving the considered. We hope it produces, for you, pages that feel grown rather than generated.",
+ signoff: "Yours,",
+ captionA: "Plot 04",
+ captionB: "Late spring",
+ },
+ salon: {
+ eyebrow: "A salon",
+ title: "A salon for the senses.",
+ lede: "Hallmark is composed, not generated. Twelve themes, twenty-one page shapes, thirty-two archetypes, all chosen with intent.",
+ ctaLabel: "By invitation",
+ proofLabel: "Of note",
+ proofA: "Centred display · ornamental",
+ proofB: "Fleuron dividers, tightly cropped",
+ proofC: "One typographic CTA per fold",
+ cta: "Be received",
+ stat: "21",
+ qualifier: "page shapes",
+ quote: "A page should arrive like a person — composed, deliberate, in good clothes.",
+ attrib: "From the salon",
+ salutation: "With pleasure,",
+ letterBody:"You are most welcome. We have arranged the room with care. Each theme is a different room, and you are invited to walk through all twelve. Take your time — they are all furnished with the same intention.",
+ signoff: "À bientôt,",
+ captionA: "Salon No. 7",
+ captionB: "April",
+ },
+ linen: {
+ eyebrow: "A note",
+ title: "Made plain.",
+ lede: "A skill that prefers the obvious thing done right. Hairline rules. Margin notes. Generous space. The page reads first, designs second.",
+ ctaLabel: "Begin reading",
+ proofLabel: "Plain rules",
+ proofA: "Two-column asymmetric body",
+ proofB: "Margin-aligned imagery",
+ proofC: "Unstyled-link CTAs",
+ cta: "Read on",
+ stat: "32",
+ qualifier: "archetypes",
+ quote: "If you can leave it out and the page still works, leave it out.",
+ attrib: "Linen rule",
+ salutation: "Dear reader,",
+ letterBody:"This is a longer letter than the other themes. It is a deliberate choice. Hallmark believes that prose-led pages still have a place — that not every product needs a hero, a stat, and a CTA stack. Sometimes, a paragraph is the page.",
+ signoff: "With patience,",
+ captionA: "Folio II",
+ captionB: "Quiet hours",
+ },
+ almanac: {
+ eyebrow: "Almanac · 2026 edition",
+ title: "Twelve themes. Twenty-one shapes.",
+ lede: "A reference book of structural choices, indexed and cross-referenced. Hallmark looks up the right page-shape for the brief and refuses to use the same one twice.",
+ ctaLabel: "Open the index",
+ proofLabel: "Catalogued",
+ proofA: "21 macrostructures",
+ proofB: "32 component archetypes",
+ proofC: "29 slop-test gates",
+ cta: "Open the index",
+ stat: "252",
+ qualifier: "theme × shape combinations",
+ quote: "An almanac is a book that knows where to look.",
+ attrib: "Almanac, frontispiece",
+ salutation: "Reference note,",
+ letterBody:"This page is a reference, not an argument. The numbers are the point: 21 macrostructures, 32 archetypes, 12 themes, 29 slop-test gates. Cross-referenced so the next page Hallmark builds is genuinely different from the last.",
+ signoff: "— editor",
+ captionA: "Vol. III",
+ captionB: "Plate 12",
+ },
+ midnight: {
+ eyebrow: "Built for the dark",
+ title: "Built for the dark.",
+ lede: "A dark theme that uses lightness for elevation, not shadow. Numbered display labels. Typewriter reveals. Indigo accent at low chroma.",
+ ctaLabel: "Run it",
+ proofLabel: "Console",
+ proofA: "OKLCH dark palette · perceptual",
+ proofB: "Lightness elevation, no shadow",
+ proofC: "Numbered display headers",
+ cta: "$ open",
+ stat: "00",
+ qualifier: "shadow halos",
+ quote: "On dark surfaces, elevation is lightness — never glow.",
+ attrib: "Midnight rule",
+ salutation: "01 — HELLO.",
+ letterBody:"This is a dark page that tries not to be a tinted-light page. The neutrals are mixed at low chroma in OKLCH so the steps feel even at the eye, not just at the value. Elevation is brighter surface, not heavier shadow.",
+ signoff: "— Midnight",
+ captionA: "Frame 03",
+ captionB: "0240h",
+ },
+ terminal: {
+ eyebrow: "$ hallmark",
+ title: "$ design.refuse_slop()",
+ lede: "Honest about its medium. Monospace top to bottom. No animations. The page is what it is.",
+ ctaLabel: "Run",
+ proofLabel: "Process",
+ proofA: "Monospace, single column",
+ proofB: "Underlined links · no hover scale",
+ proofC: "No reveal animation",
+ cta: "$ run",
+ stat: "0",
+ qualifier: "animations",
+ quote: "$ tput sgr0",
+ attrib: "End of file",
+ salutation: "> hello",
+ letterBody:"> a terminal page is not a page that pretends. it does not transition. it does not hover-scale. it is monospace because the work that made it was monospace. the rest of the page can read what it likes.",
+ signoff: "> bye",
+ captionA: "frame_07",
+ captionB: "0241",
+ },
+ brutal: {
+ eyebrow: "Brutal — uncompromised",
+ title: "NO COMPROMISE.",
+ lede: "Heavy display. Hard edges. One accent that means it. The grid does not flex; the grid is the point.",
+ ctaLabel: "Take it",
+ proofLabel: "Stack",
+ proofA: "Photographic full-bleed",
+ proofB: "Bleed-colour dividers",
+ proofC: "Oversized solid CTAs",
+ cta: "GO",
+ stat: "100",
+ qualifier: "PERCENT.",
+ quote: "A page that hedges is a page that fails.",
+ attrib: "BRUTAL",
+ salutation: "DEAR READER.",
+ letterBody:"WE WILL NOT HEDGE. THE GRID DOES NOT FLEX. THE TYPE IS HEAVY. THE ACCENT IS RED. EVERY DECISION ON THIS PAGE IS A DECISION; NONE OF THEM ARE DEFAULTS. TAKE IT OR LEAVE IT.",
+ signoff: "— BRUTAL",
+ captionA: "BLOCK A",
+ captionB: "PRINT 01",
+ },
+ manifesto: {
+ eyebrow: "Manifesto",
+ title: "WE REJECT THE TEMPLATE.",
+ lede: "The page is a statement. We don't soften it. The accent is a colour with a position. The headline is a belief.",
+ ctaLabel: "Sign it",
+ proofLabel: "Beliefs",
+ proofA: "Bleed-colour dividers",
+ proofB: "Oversized solid buttons",
+ proofC: "Declarative large type",
+ cta: "SIGN ON",
+ stat: "23",
+ qualifier: "tells, named.",
+ quote: "WE BELIEVE A LANDING PAGE IS NOT A TEMPLATE.",
+ attrib: "MANIFESTO",
+ salutation: "TO WHOM IT CONCERNS.",
+ letterBody:"WE BELIEVE THE PAGE IS A POSITION. WE BELIEVE THE TEMPLATE IS THE ENEMY. WE BELIEVE THAT EVERY DECISION SHOULD BE VISIBLE FROM ACROSS THE ROOM. WE BELIEVE THE ACCENT COLOUR IS A POLITICS. WE BELIEVE — AND THE PAGE BELIEVES WITH US.",
+ signoff: "— THE UNDERSIGNED",
+ captionA: "PLATE I",
+ captionB: "POSTER",
+ },
+ sport: {
+ eyebrow: "Sport · 2026",
+ title: "BUILT TO SHIP.",
+ lede: "Italic display. Tabular nums. Numbered display headers. The page moves like a scoreboard — fast, decisive, in motion.",
+ ctaLabel: "Kick off",
+ proofLabel: "Stats",
+ proofA: "Italic display, oversized",
+ proofB: "Tabular numbers everywhere",
+ proofC: "Horizontal-sweep reveals",
+ cta: "GO",
+ stat: "+47%",
+ qualifier: "FASTER · DECIDE LATE.",
+ quote: "A FAST PAGE IS A FAST DECISION.",
+ attrib: "SPORT",
+ salutation: "READY?",
+ letterBody:"YOU ARE TWO MINUTES FROM SHIPPING. THE PAGE IS WAITING. EVERY DECISION ON IT IS NUMBERED, TABULATED, INDEXED. THE ACCENT IS A STARTING GUN. RUN IT.",
+ signoff: "— SPORT",
+ captionA: "RACE 03",
+ captionB: "LAP 12",
+ },
+};
+
+/* — Slot population ———————————————————————————————————— */
const root = document.documentElement;
-const themer = document.querySelector(".themer");
-const trigger = document.getElementById("themer-trigger");
-const panel = document.getElementById("themer-panel");
+const banner = document.querySelector(".banner");
const currentLabel = document.querySelector("[data-theme-current]");
-const buttons = document.querySelectorAll("[data-theme-btn]");
+const dots = document.querySelectorAll("[data-theme-btn]");
+const slotEls = {
+ hero: document.querySelector('[data-slot="hero"]'),
+ footer: document.querySelector('[data-slot="footer"]'),
+};
+
+function interpolate(node, copy) {
+ // Walk text nodes and attribute values, replace {{key}} with copy[key].
+ const walker = document.createTreeWalker(node, NodeFilter.SHOW_TEXT, null);
+ const textNodes = [];
+ let n; while ((n = walker.nextNode())) textNodes.push(n);
+ for (const t of textNodes) {
+ if (t.nodeValue.includes("{{")) {
+ t.nodeValue = t.nodeValue.replace(/\{\{(\w+)\}\}/g, (_, k) => copy[k] ?? "");
+ }
+ }
+ // Attributes
+ const all = node.querySelectorAll("*");
+ for (const el of all) {
+ for (const attr of el.attributes) {
+ if (attr.value.includes("{{")) {
+ attr.value = attr.value.replace(/\{\{(\w+)\}\}/g, (_, k) => copy[k] ?? "");
+ }
+ }
+ }
+}
+
+function buildDenseColophon(themeName) {
+ // Pre-formatted dense block for the dense footer. Generated rather than
+ // template-string'd so it stays monospace-aligned.
+ const today = "2026-04-28";
+ return [
+ `# hallmark · v0.2 · ${themeName.toLowerCase()}`,
+ `# build: ${today} · MIT · powered by together ai`,
+ `#`,
+ `# influences:`,
+ `# pbakaus/impeccable — the named-tells canon`,
+ `# tw93/kami — the slop-test concept`,
+ `# leonxlnx/taste-skill — taste vocabulary`,
+ `# anthropics/skills — frontend-design skill`,
+ `#`,
+ `# stats: 21 macrostructures · 32 archetypes · 12 themes · 29 gates`,
+ ].join("\n");
+}
+
+function swapArchetypes(theme) {
+ const tuple = ARCHETYPES[theme] || ARCHETYPES.specimen;
+ const copy = { ...COPY[theme], denseColophon: buildDenseColophon(THEMES[theme] || theme) };
+
+ for (const slot of ["hero", "footer"]) {
+ const region = slotEls[slot];
+ if (!region) continue;
+ const tplId = `${slot}-${tuple[slot]}`;
+ const tpl = document.getElementById(tplId);
+ if (!tpl) continue;
+
+ const fragment = tpl.content.cloneNode(true);
+ interpolate(fragment, copy);
+
+ region.replaceChildren(fragment);
+ region.dataset.archetype = tuple[slot];
+
+ // Trigger a one-shot fade-in for the freshly-populated children.
+ region.removeAttribute("data-populating");
+ void region.offsetWidth; // restart animation
+ region.setAttribute("data-populating", "");
+ }
+
+ // Re-attach copy buttons inside the new hero, since clone doesn't carry handlers.
+ attachCopyButtons(slotEls.hero);
+}
+/* — Copy-to-clipboard (silent success, label swap pattern) ————— */
+function attachCopyButtons(scope = document) {
+ const btns = scope.querySelectorAll("[data-copy-btn]:not([data-copy-bound])");
+ btns.forEach((btn) => {
+ btn.dataset.copyBound = "true";
+ btn.addEventListener("click", async () => {
+ const source = btn.closest("[data-copy-source]");
+ const textNode = source && source.querySelector("[data-copy-text]");
+ const text = textNode ? textNode.textContent.trim() : "";
+ if (!text) return;
+
+ try {
+ await navigator.clipboard.writeText(text);
+ } catch (err) {
+ const ta = document.createElement("textarea");
+ ta.value = text;
+ ta.setAttribute("readonly", "");
+ ta.style.position = "fixed";
+ ta.style.left = "-9999px";
+ document.body.appendChild(ta);
+ ta.select();
+ try { document.execCommand("copy"); } catch (e) {}
+ document.body.removeChild(ta);
+ }
+
+ btn.dataset.state = "copied";
+ btn.setAttribute("aria-live", "polite");
+ clearTimeout(btn._copyTimer);
+ btn._copyTimer = setTimeout(() => {
+ delete btn.dataset.state;
+ }, 2200);
+ });
+ });
+}
+attachCopyButtons();
+
+/* — Theme application ————————————————————————————————— */
function setPressed(theme) {
- buttons.forEach((btn) => {
+ dots.forEach((btn) => {
const active = btn.dataset.themeBtn === theme;
btn.setAttribute("aria-pressed", active ? "true" : "false");
});
@@ -92,6 +431,7 @@ function applyTheme(theme) {
const apply = () => {
root.dataset.theme = theme;
setPressed(theme);
+ swapArchetypes(theme);
try { localStorage.setItem(STORAGE_KEY, theme); } catch (e) {}
};
if (!reduced && document.startViewTransition) {
@@ -101,85 +441,73 @@ function applyTheme(theme) {
}
}
+const queried = (() => {
+ try { return new URL(window.location.href).searchParams.get("theme"); } catch (e) { return null; }
+})();
const stored = (() => {
try { return localStorage.getItem(STORAGE_KEY); } catch (e) { return null; }
})();
-const initial = THEMES[stored] ? stored : (root.dataset.theme || "specimen");
+const initial = THEMES[queried] ? queried
+ : THEMES[stored] ? stored
+ : (root.dataset.theme || "specimen");
+
+// First paint — populate slots without a transition (no flash).
+root.dataset.theme = initial;
setPressed(initial);
+swapArchetypes(initial);
+try { localStorage.setItem(STORAGE_KEY, initial); } catch (e) {}
-buttons.forEach((btn) => {
+dots.forEach((btn) => {
btn.addEventListener("click", () => {
applyTheme(btn.dataset.themeBtn);
- closePanel();
- trigger.focus();
});
});
-/* — Popover open/close ————————————————————————————————— */
-function isOpen() { return themer.getAttribute("aria-expanded") === "true"; }
-
-function openPanel() {
- themer.setAttribute("aria-expanded", "true");
- trigger.setAttribute("aria-expanded", "true");
- document.addEventListener("keydown", onKey);
- document.addEventListener("click", onOutside, { capture: true });
- // Focus the currently-pressed theme button so arrow keys make sense
- const active = panel.querySelector('[aria-pressed="true"]') || panel.querySelector("[data-theme-btn]");
- if (active) {
- requestAnimationFrame(() => active.focus());
- }
+/* — Random button + R shortcut ——————————————————————————— */
+const randomBtn = document.querySelector(".banner__random");
+function pickRandomTheme() {
+ const keys = Object.keys(THEMES).filter((k) => k !== root.dataset.theme);
+ return keys[Math.floor(Math.random() * keys.length)];
}
-
-function closePanel() {
- themer.setAttribute("aria-expanded", "false");
- trigger.setAttribute("aria-expanded", "false");
- document.removeEventListener("keydown", onKey);
- document.removeEventListener("click", onOutside, { capture: true });
+if (randomBtn) {
+ randomBtn.addEventListener("click", () => applyTheme(pickRandomTheme()));
}
-function togglePanel() { isOpen() ? closePanel() : openPanel(); }
-
-trigger.addEventListener("click", (e) => {
- e.stopPropagation();
- togglePanel();
-});
-
-function onKey(e) {
- if (e.key === "Escape") {
- closePanel();
- trigger.focus();
- }
-}
-
-function onOutside(e) {
- if (!themer.contains(e.target)) closePanel();
-}
-
-// Arrow-key navigation in the panel
-panel.addEventListener("keydown", (e) => {
- const focusables = Array.from(panel.querySelectorAll("[data-theme-btn]"));
- const i = focusables.indexOf(document.activeElement);
- if (i < 0) return;
- let next = i;
- if (e.key === "ArrowDown" || e.key === "ArrowRight") next = (i + 1) % focusables.length;
- else if (e.key === "ArrowUp" || e.key === "ArrowLeft") next = (i - 1 + focusables.length) % focusables.length;
- else if (e.key === "Home") next = 0;
- else if (e.key === "End") next = focusables.length - 1;
- else return;
- e.preventDefault();
- focusables[next].focus();
-});
-
-/* — Global keyboard shortcuts ————————————————————————————— */
-// "T" opens the theme picker — shown via the delay-revealed kbd hint.
+/* — Keyboard shortcuts ————————————————————————————————— */
+// T cycles forward, Shift+T cycles back, R picks random.
document.addEventListener("keydown", (e) => {
- // Don't intercept if the user is typing in an input
const tag = (e.target.tagName || "").toLowerCase();
if (tag === "input" || tag === "textarea" || e.target.isContentEditable) return;
if (e.metaKey || e.ctrlKey || e.altKey) return;
if (e.key === "t" || e.key === "T") {
e.preventDefault();
- if (!isOpen()) openPanel();
+ const order = Object.keys(THEMES);
+ const i = order.indexOf(root.dataset.theme);
+ const dir = e.shiftKey ? -1 : 1;
+ const next = order[(i + dir + order.length) % order.length];
+ applyTheme(next);
+ } else if (e.key === "r" || e.key === "R") {
+ e.preventDefault();
+ applyTheme(pickRandomTheme());
}
});
+
+/* — Hover preview on dots — reads theme name in the centre ————— */
+let previewTimer = null;
+let lastConfirmed = root.dataset.theme;
+dots.forEach((btn) => {
+ btn.addEventListener("mouseenter", () => {
+ lastConfirmed = root.dataset.theme;
+ clearTimeout(previewTimer);
+ previewTimer = setTimeout(() => {
+ if (currentLabel) currentLabel.textContent = THEMES[btn.dataset.themeBtn];
+ }, 80);
+ });
+ btn.addEventListener("mouseleave", () => {
+ clearTimeout(previewTimer);
+ if (currentLabel && root.dataset.theme === lastConfirmed) {
+ currentLabel.textContent = THEMES[lastConfirmed];
+ }
+ });
+});
diff --git a/skill/SKILL.md b/skill/SKILL.md
index 0be0952..237e670 100644
--- a/skill/SKILL.md
+++ b/skill/SKILL.md
@@ -100,7 +100,7 @@ Always:
### 5. The slop test
-Before handing back, run the output through these twenty-three questions. Every answer must be **no**.
+Before handing back, run the output through these twenty-nine questions. Every answer must be **no**.
**Visual:**
@@ -137,6 +137,15 @@ Before handing back, run the output through these twenty-three questions. Every
22. Is the macrostructure I picked the same as a previous Hallmark output's stamp in this project? (Read the file system; if a stamp exists, mine must differ.)
23. Did I default to the **Specimen** macrostructure (numbered left-margin labels + huge serif + asymmetric spans + typographic-only CTA) when the brief did not explicitly call for editorial / foundry / specimen energy? (Specimen fall-through is banned.)
+**Implementation gates** (the rules that used to be advice; now they're checks):
+
+24. Does any neutral / surface colour have `oklch(... 0 ...)` (zero chroma)? Pure greys read as flat. Tint every neutral toward the anchor hue — minimum 0.005 chroma.
+25. Does the accent colour cover more than ~5 % of any single viewport (count by area: solid fills, large headings in accent, full-bleed accent backgrounds)? If yes, retreat — accent is for emphasis, not for filling.
+26. Is any padding / gap / margin a value that isn't on the named spacing scale (`--space-3xs` … `--space-5xl`, multiples of 4 px)? Arbitrary `padding: 17px` is a tell.
+27. Is any prose container's `max-width` outside the 45–75 ch range? Measure must read; under 45 ch is choppy, over 75 ch loses the eye.
+28. Does any interactive element lack `:focus-visible`, `:active`, OR `:disabled` styling? (Eight states is the rule. Default + hover is two; you need at least default + hover + focus-visible + active + disabled present in code.)
+29. Is there any `transform` / `animation` keyframe that is NOT covered by a `@media (prefers-reduced-motion: reduce)` fallback? Every motion gets a reduced-motion alternative.
+
If any answer is yes, fix it. Do not ship slop.
---
@@ -154,6 +163,8 @@ Group by severity. Do not edit. Do not redesign. End with a count: `N critical
Audit *also* checks structural fingerprint: if the page uses the AI template (centered hero, 3 equal feature cards, CTA, footer, with no asymmetry or surprise), flag it as a critical structural finding even if the visual treatment is fine.
+**Stamp-vs-page check.** If the audited file contains a `/* Hallmark · macrostructure: <name> · ... */` stamp, verify the page actually matches that name. If the stamp says **Bento Grid** but the page is a centered single-column hero with a CTA, flag it as a critical structural finding: `stamp lies` — the stamp must reflect what shipped or be removed. This catches drift where a previous Hallmark run stamped one thing and a later edit pulled the page back toward the AI template.
+
---
## `hallmark refine`
diff --git a/skill/references/component-cookbook.md b/skill/references/component-cookbook.md
index 0dc2918..aa555e6 100644
--- a/skill/references/component-cookbook.md
+++ b/skill/references/component-cookbook.md
@@ -1,6 +1,6 @@
# Component cookbook
-Thirty-two component archetypes you can compose into any macrostructure. Every entry: a *shape*, a one-line "use when", a one-line "don't confuse with", and a short structural sketch (DOM + minimal CSS). Pick from this file when you're building a section and don't know which shape to reach for.
+Thirty-three component archetypes you can compose into any macrostructure. Every entry: a *shape*, a one-line "use when", a one-line "don't confuse with", and a short structural sketch (DOM + minimal CSS). Pick from this file when you're building a section and don't know which shape to reach for.
The same macrostructure (e.g., Bento Grid) can be built from many different combinations of these archetypes. The macrostructure picks the *page shape*; this file picks the *components inside it*.
@@ -8,6 +8,51 @@ The same macrostructure (e.g., Bento Grid) can be built from many different comb
---
+## Within-archetype variation knobs
+
+Picking an archetype is the first axis of variety. The second is *how you build it*. Two pages built with the same archetype should not be identical — each archetype below has 2–3 *variation knobs*. Pick one value per knob per output. This prevents "every Bento I build looks like the same Bento."
+
+When you pick an archetype, **state the knob values you chose** in the macrostructure stamp comment, e.g.:
+
+```css
+/* Hallmark · macrostructure: Bento Grid · F1 Bento knobs: tiles=6, spans=irregular, accent=corner-only · ... */
+```
+
+| Archetype | Knob A | Knob B | Knob C |
+| --- | --- | --- | --- |
+| **H1 Marquee** | Display size: `xxl` (clamp 4–12rem) · `xl` (clamp 3–8rem) | Alignment: left-bias · centred · right-bias | Underlay: none · single rule above · single rule below |
+| **H2 Split Diptych** | Ratio: 7/5 · 6/6 · 5/7 | Right side: photo · proof column · pull-quote | Divider: hairline · negative space · vertical rule |
+| **H3 Quote-Led** | Quote weight: italic display · roman display · roman body large | Attribution position: under quote · margin-aligned · right-flush | Length: ≤80 chars · 80–160 chars |
+| **H4 Stat-Led** | Number style: tabular display · italic display · monospace | Qualifier position: below · inline-right · stacked-above | Secondary stats: none · two below · row of four |
+| **H5 Letter** | Salutation: greeting · "Dear X," · time-stamp | Body length: 1 paragraph · 2 paragraphs · 3 paragraphs | Signoff: typed name · drawn signature SVG · initials |
+| **H6 Photographic** | Image area: full-bleed · 16/7 · 4/3 · 1/1 square | Caption position: lower-left · upper-right · margin | Text below or overlaid |
+| **F1 Bento (feature)** | Tiles: 4 · 6 · 7 · 9 | Spans: regular · irregular · mosaic | Border: hairline all · accent corners · none |
+| **F2 Sticky-scroll stack** | Pinned side: left · right | Right pane content: code · screenshot · diagram | Pin steps: 3 · 4 · 5 |
+| **F3 Tabular spec sheet** | Columns: 2 (key/val) · 3 (key/val/unit) · 4 (with footnote) | Rule density: every row · groups of 3 · headers only | Numbers: tabular · proportional |
+| **F4 Step sequence** | Numbering: I/II/III · 01/02/03 · 1.0/2.0/3.0 | Layout: vertical stack · horizontal flow · diagonal | Connector: line · arrow · none |
+| **F5 Annotated screenshot** | Callouts: numbered pins · margin labels · inline arrows | Frame: device · plain · floating | Anchor: image-led or text-led |
+| **F6 Product card grid** | Card ratio: 3/4 portrait · 1/1 square · 4/3 landscape | Density: 3-up · 4-up · 5-up | Micro-action: Add · Save · View → · none |
+| **C1 Outlined chip** | Shape: rectangular · pill (only allowed for tactile/playful tones) · slab | Density: spacious · compact | Adornment: arrow · plus · none |
+| **C2 Inline form-as-CTA** | Field count: 1 · 2 · 3 | Submit position: end-of-row · separate line · embedded button | Helper: above · below · none |
+| **C3 Typographic link CTA** | Underline: solid · dashed · double · none | Hover behaviour: thicken · slide · colour shift | Arrow: → · ↗ · none |
+| **C4 Sticky bottom bar** | Reveal: always · scroll-up · after fold | Anchored: viewport bottom · viewport top · inline at bottom | Shadow: hairline · none · subtle |
+| **T1 Pull quote w/ marginalia** | Quote treatment: italic display · roman large · serif italic | Attribution: signed · stamped · timestamped | Marginalia: none · timeline · 1 footnote |
+| **T2 Logo wall (hairline)** | Layout: single row · 2 rows · grid 3×N | Logo treatment: monochrome ink · brand colour · ghosted | Divider: hairline cells · none |
+| **T3 Single huge quote** | Quote face: serif italic · roman display · italic mono | Width: full-bleed · 60ch · 40ch | Attribution position: same line · separate band |
+| **T4 Numbered stat strip** | Layout: 3-up · 4-up · 5-up · 6-up | Number weight: display · body large | Qualifier position: under · inline · above |
+| **Ft1 Mast-headed** | Wordmark size: display 3xl · display 2xl · xl | Tagline: italic serif · roman body · none | Links row: inline · 2-line stack |
+| **Ft2 Inline single line** | Order: wordmark/links/credit · credit/wordmark/links | Separator: middot · pipe · em-dash · vertical rule | Density: dense · spaced |
+| **Ft3 Index columns** | Columns: 3 · 4 · 5 | Heading style: small caps · italic · monospace | Bullet: hairline · none |
+| **Ft4 Dense colophon** | Family: monospace · serif · sans | Layout: single block · paragraphs · log-style | Includes: build hash · date · attribution |
+| **N1 Wordmark + 2 links** | Position: left/right split · centred · right-flush | Links: text · text+icon · pill | Sticky: yes · no |
+| **N2 Floating chip** | Anchor: top · bottom · top-right · bottom-left | Content: theme picker · search · navigation | Backdrop: blur · solid · none |
+| **N3 Side-rail** | Side: left · right | Width: 12ch · 16ch · 20ch | Indicator: filled bar · text-only · numbered |
+| **N4 Hidden behind ⌘K** | Trigger: button · keyboard only · both | Surface: modal · sheet · spotlight | Recents: shown · hidden |
+
+**Anti-pattern:** picking the same knob values across two different outputs is the same kind of templating as picking the same archetype. If your last Bento was `tiles=6, spans=irregular, accent=corner-only`, the next one must change at least one knob.
+
+---
+
## Heroes
### H1 · Marquee
@@ -247,6 +292,46 @@ A product capture sits centre-stage with arrows or short labels pointing to UI d
</figure>
```
+### F6 · Product card grid
+Each card is a product, not a feature. Image · name · price · one micro-action. Reads like a shop floor, not a marketing site.
+*Use when:* the brief is commerce, catalogue, lookbook, marketplace — anything where the page sells *things*, not *features*.
+*Don't confuse with:* F1 Bento (which sells *features*; tiles vary in size and span). Product cards are uniform on purpose — the rhythm comes from the products, not the layout.
+
+**Variation knobs:** card ratio (3/4 portrait · 1/1 square · 4/3 landscape) · density (3-up · 4-up · 5-up) · price treatment (under name · over image · hover-reveal) · micro-action (Add · Save · View → · none).
+
+```html
+<section class="product-grid">
+ <article class="product">
+ <a class="product__media" href=""><img src="" alt="" loading="lazy" /></a>
+ <div class="product__meta">
+ <h3 class="product__name">Linen Apron · Indigo</h3>
+ <p class="product__price tabular-nums">¥ 6,400</p>
+ </div>
+ <button class="product__add" aria-label="Add Linen Apron to bag">+</button>
+ </article>
+ <!-- ... more products, uniform shape ... -->
+</section>
+```
+```css
+.product-grid { display: grid; grid-template-columns: repeat(3, 1fr); gap: var(--space-xl) var(--space-lg); }
+@media (max-width: 60rem) { .product-grid { grid-template-columns: repeat(2, 1fr); } }
+.product { display: grid; gap: var(--space-sm); position: relative; }
+.product__media { display: block; aspect-ratio: 3 / 4; background: var(--color-paper-2); overflow: hidden; }
+.product__media img { width: 100%; height: 100%; object-fit: cover; transition: transform var(--dur-long) var(--ease-out); }
+.product__media:hover img { transform: scale(1.02); }
+.product__name { font-family: var(--font-body); font-size: var(--text-md); margin: 0; }
+.product__price { font-family: var(--font-mono); font-size: var(--text-sm); color: var(--color-ink-2); }
+.product__add { position: absolute; top: var(--space-sm); right: var(--space-sm); width: 32px; height: 32px; background: var(--color-paper); border: var(--rule-hair) solid var(--color-rule-2); cursor: pointer; opacity: 0; transition: opacity var(--dur-short) var(--ease-out); }
+.product:hover .product__add, .product:focus-within .product__add { opacity: 1; }
+@media (pointer: coarse) { .product__add { opacity: 1; } }
+```
+
+**Anti-patterns to avoid in product grids:**
+- Don't borrow Bento's irregular spans — products want uniform rhythm.
+- Don't put feature-style two-line descriptions under product names. The price *is* the description.
+- Don't auto-scale the image on idle — only on hover, and only by 1.02× max.
+- Don't use cards with shadow + radius + border + tile + ribbon. Pick one container signal.
+
---
## CTAs / signups
diff --git a/skill/references/structure.md b/skill/references/structure.md
index 73f576b..b189571 100644
--- a/skill/references/structure.md
+++ b/skill/references/structure.md
@@ -120,12 +120,32 @@ Reject these structural fingerprints. They are the AI-template fingerprint.
## When you don't know
-If the brief doesn't suggest a fingerprint and the user hasn't picked a theme, **do not default**. Offer the user three named macrostructures from *categorically different* groups, and let them pick. For example:
+If the brief doesn't suggest a fingerprint and the user hasn't picked a theme, **do not default**. Read the brief for a domain word (audio, commerce, docs, agency, restaurant, fashion, fintech, personal, …) and offer the user **three macrostructures from categorically different groups *that fit that domain***. Then let them pick.
-- **Bento Grid** — modular, feature-led, many entry points.
-- **Long Document** — prose-led, one continuous narrative, no marketing structure.
-- **Manifesto** — declarative large type, one belief per fold, polemical.
+The point of three is contrast: a grid-led shape, a document-led shape, a poster-led shape. Picking from categorically different groups is what produces variety; offering three near-twins is the AI tell this whole skill exists to defeat.
-Three concrete page-shapes beat seven abstract tones. If the user shrugs and says "you pick", roll a die: pick whichever of the three is most *categorically distant* from any previous Hallmark output for this user (read the existing CSS for a `/* Hallmark · macrostructure: ... */` stamp and avoid that family).
+### Domain → trio (offer these three; never default)
-If the user answers a vague tone word ("modern", "clean", "professional"), that is not a feeling. Re-ask with the three concrete macrostructures above.
+If you can't infer the domain, ask one question — "what does this thing do?" — and then map it.
+
+| Domain words in the brief | Trio to offer |
+| --- | --- |
+| **podcast, audio, music, playlist, listening** | **Photographic** · **Quote-Led** · **Letter** |
+| **shop, store, product, merch, commerce, ecom** | **Catalogue** · **Photographic** · **Bento Grid** |
+| **docs, CLI, SDK, API, library, developer, terminal** | **Workbench** · **Long Document** · **Component Playground** |
+| **agency, studio, portfolio, freelance, creative shop** | **Portfolio Grid** · **Split Studio** · **Index-First** |
+| **restaurant, café, bar, food, kitchen, menu** | **Photographic** · **Long Document** · **Catalogue** |
+| **fashion, apparel, beauty, lookbook** | **Photographic** · **Catalogue** · **Marquee Hero** |
+| **fintech, banking, payments, invest, trading** | **Stat-Led** · **Workbench** · **Long Document** |
+| **personal, resume, one-pager, about-me, individual** | **Long Document** · **Letter** · **Index-First** |
+| **manifesto, campaign, cause, advocacy, political** | **Manifesto** · **Quote-Led** · **Stat-Led** |
+| **editorial, foundry, magazine, type, specimen** | **Specimen** · **Long Document** · **Type Specimen** |
+| **product launch, SaaS marketing, B2B** | **Bento Grid** · **Workbench** · **Stat-Led** |
+| **conference, event, speaker, keynote** | **Marquee Hero** · **Manifesto** · **Photographic** |
+| **fallback (genuinely no signal)** | **Bento Grid** · **Long Document** · **Manifesto** |
+
+If the user shrugs and says "you pick", read the project's CSS for a `/* Hallmark · macrostructure: ... */` stamp; whichever of the trio is most categorically distant from the stamped family is the right pick. Two consecutive outputs should never be from the same family — never two editorial macrostructures, never two grid-led macrostructures.
+
+If the user answers a vague tone word ("modern", "clean", "professional"), that is not a feeling. Re-ask with the domain trio.
+
+The fallback row at the bottom of the table is the *last* resort — only if no domain words appear and the user genuinely cannot pick. In practice, almost every brief contains a domain word; using the fallback usually means you didn't read carefully enough.