@stylecrib/cli 0.3.1 → 0.3.3

package/themes/podcast-warm/tokens.ts

@@ -0,0 +1,192 @@
+import type { Direction } from "../schema";
+
+export const podcastWarm: Direction = {
+  name: "podcast-warm",
+  ethos:
+    "Overcast warm orange · Pocket Casts deep red · Castro deep teal-green · Goodpods community warmth · Snipd purple clip-cards",
+  references: [
+    { brand: "Overcast", trait: "warm orange accent with friendly system sans and soft cards" },
+    { brand: "Pocket Casts", trait: "deep red action color with smooth animations and warm surfaces" },
+    { brand: "Castro", trait: "deep teal-green chrome with a friendly, library-shelf feel" },
+    { brand: "Goodpods", trait: "community-warm Plus Jakarta Sans, recommendation-led layout" },
+    { brand: "Snipd", trait: "purple clip-cards and friendly AI-generated chapter chrome" },
+  ],
+  feel:
+    "Warm off-white canvas, generously rounded chrome, oversized artwork tiles in a subscribed-shows " +
+    "grid. Friendly secondary palette of teal-green and clip-card purple. The independent-listener counterpoint " +
+    "to Spotify's cold corporate dark — this surface feels like a curated shelf of shows, not a streaming dashboard.",
+
+  fonts: {
+    display: {
+      family: "Plus Jakarta Sans",
+      fallback: ["Manrope", "Inter", "system-ui", "-apple-system", "sans-serif"],
+      from: "Goodpods display sans — friendly geometric humanist, soft terminals, podcast-app warm",
+      googleFont: "Plus+Jakarta+Sans",
+      weights: [500, 600, 700, 800],
+    },
+    body: {
+      family: "Inter",
+      fallback: ["system-ui", "-apple-system", "BlinkMacSystemFont", "Segoe UI", "sans-serif"],
+      from: "Overcast/Pocket Casts system-feel sans — neutral, screen-comfortable for episode descriptions",
+      googleFont: "Inter",
+      weights: [400, 500, 600],
+    },
+    mono: {
+      family: "JetBrains Mono",
+      fallback: ["Berkeley Mono", "ui-monospace", "SFMono-Regular", "Consolas", "monospace"],
+      from: "episode runtimes, chapter timestamps, playback speed — tabular numerics",
+      googleFont: "JetBrains+Mono",
+      weights: [400, 500],
+    },
+  },
+
+  typography: {
+    headingTracking: "-0.015em",
+    bodyTracking: "0",
+    fontFeatureSettings: '"ss01", "cv11", "tnum"',
+    h1ScaleClamp: "clamp(2.25rem, 6vw, 4.5rem)",   // friendly hero scale — not cinematic-large
+    bodyBaseSize: "1rem",                           // 16px — episode description comfort
+    bodyLineHeight: "1.6",
+  },
+
+  colors: {
+    background: { hsl: "32 30% 96%", from: "warm off-white canvas — Overcast paper, library-shelf cream" },
+    foreground: { hsl: "24 20% 16%", from: "warm dark brown-ink — never pure black on warm cream" },
+    card: { hsl: "0 0% 100%", from: "show-tile and episode card — pure white on cream, friendly lift" },
+    popover: { hsl: "0 0% 100%", from: "menu and tooltip surface — same as card with stronger shadow" },
+    primary: { hsl: "18 88% 56%", from: "Overcast warm orange — the canonical 'Play' action across the player" },
+    primaryForeground: { hsl: "0 0% 100%", from: "white on Overcast orange" },
+    secondary: { hsl: "32 24% 92%", from: "deeper warm cream — quiet panels inside friendly pages" },
+    secondaryForeground: { hsl: "24 20% 16%", from: "brown-ink on deeper cream" },
+    muted: { hsl: "32 20% 90%", from: "muted surface — playlist row hover, soft dividers" },
+    mutedForeground: { hsl: "24 12% 42%", from: "episode-meta secondary text — duration, dateline, host name" },
+    accent: { hsl: "168 52% 38%", from: "Castro teal-green hover/selection accent — the warm secondary" },
+    accentForeground: { hsl: "0 0% 100%", from: "white on Castro teal-green" },
+    border: { hsl: "32 18% 84%", from: "soft warm border — softer than editorial hairline, friendlier" },
+    input: { hsl: "32 18% 84%", from: "same as border — input chrome uses the soft border language" },
+    ring: { hsl: "18 88% 56%", from: "Overcast orange focus ring — matches primary play action" },
+    destructive: { hsl: "356 70% 50%", from: "remove-from-queue red — distinct from Pocket Casts brand red below" },
+    destructiveForeground: { hsl: "0 0% 100%", from: "white on destructive red" },
+    brand: {
+      "overcast-orange": { hsl: "18 88% 56%", from: "= primary; Overcast warm orange, canonical play color" },
+      "pocketcasts-red": { hsl: "356 78% 52%", from: "Pocket Casts deep red — secondary brand accent for 'Subscribed' badges" },
+      "castro-teal": { hsl: "168 52% 38%", from: "= accent; Castro deep teal-green, friendly category color" },
+      "snipd-purple": { hsl: "266 70% 60%", from: "Snipd clip-card purple — used on chapter clips and AI-summary chrome" },
+      "goodpods-pink": { hsl: "338 75% 65%", from: "Goodpods community pink — recommendation-card highlight" },
+      "warm-cream": { hsl: "32 30% 96%", from: "= background; warm off-white canvas, also a semantic token" },
+      "shelf-brown": { hsl: "24 20% 16%", from: "= foreground; warm brown-ink, also semantic for library-shelf chrome" },
+    },
+  },
+
+  spacing: {
+    base: 4,
+    scale: [4, 8, 12, 16, 20, 24, 32, 40, 48, 64, 80, 96, 128],   // medium — friendly breathing, room for cards
+    containerMax: "max-w-6xl",
+    containerPadding: "px-5 lg:px-8",
+    sectionPadding: {
+      hero: "pt-20 pb-14 lg:pt-32 lg:pb-20",
+      default: "py-16 lg:py-24",
+      tight: "py-10 lg:py-14",
+    },
+  },
+
+  radius: {
+    base: "1rem",                       // generously rounded — the warm-chrome signal
+    pillsAllowed: true,                 // pills are core: category chips, subscribe toggles, play-speed selectors
+  },
+
+  shadows: {
+    style: "soft",
+    utilities: {
+      "tile-soft":
+        "0 1px 2px hsl(24 20% 16% / 0.06), " +
+        "0 8px 24px hsl(24 20% 16% / 0.08)",   // show-artwork tile lift — warm, soft, never glossy
+      "tile-lift":
+        "0 4px 8px hsl(24 20% 16% / 0.08), " +
+        "0 16px 40px hsl(24 20% 16% / 0.12)",   // hover state — the tile rises on hover
+      "subscribe-glow":
+        "0 0 0 2px hsl(var(--overcast-orange) / 0.25), " +
+        "0 8px 24px hsl(var(--overcast-orange) / 0.2)",   // hero subscribe button warm glow
+    },
+  },
+
+  motion: {
+    easing: "cubic-bezier(0.22, 1, 0.36, 1)",
+    durations: {
+      reveal: 500,                    // friendly, immediate — not slow-editorial, not snap-app
+      loop: 1800,                     // play-bar bounce, chapter-progress pulse
+      ambient: 8000,                  // slow tile-shimmer on featured shows
+    },
+    keyframes: {
+      "tile-rise": {
+        css:
+          "from { opacity: 0; transform: translateY(16px); }\n" +
+          "to { opacity: 1; transform: translateY(0); }",
+        defaultDuration: 500,
+        iteration: "once",
+        purpose: "show-tile entrance — staggered across grid, gentle rise",
+      },
+      "subscribe-pop": {
+        css:
+          "0% { transform: scale(1); }\n" +
+          "40% { transform: scale(1.08); }\n" +
+          "100% { transform: scale(1); }",
+        defaultDuration: 400,
+        iteration: "once",
+        purpose: "subscribe-button click feedback — friendly pop, never on play/pause",
+      },
+      "play-bar-bounce": {
+        css:
+          "0%, 100% { transform: translateY(0); }\n" +
+          "50% { transform: translateY(-4px); }",
+        defaultDuration: 1800,
+        iteration: "infinite",
+        purpose: "now-playing mini-bar gentle bounce — present but unobtrusive",
+      },
+      "chapter-progress": {
+        css:
+          "from { transform: scaleX(0); }\n" +
+          "to { transform: scaleX(1); }",
+        defaultDuration: 1200,
+        iteration: "once",
+        purpose: "chapter-marker fill animation on episode-page chapter list",
+      },
+      "tile-shimmer": {
+        css:
+          "0% { background-position: -150% 0; }\n" +
+          "100% { background-position: 150% 0; }",
+        defaultDuration: 2400,
+        iteration: "infinite",
+        purpose: "featured-show artwork shimmer overlay — used only on the hero featured tile",
+      },
+    },
+    respectsReducedMotion: true,
+  },
+
+  density: "medium",
+
+  patterns: {
+    button:
+      "Primary play action is a SOLID rounded-full overcast-orange button with white play glyph. " +
+      "Subscribe toggle is a pill: outlined Castro-teal when 'subscribe', filled when 'subscribed'. " +
+      "Secondary controls (queue, share, download) are ghost icon buttons with 1rem radius. " +
+      "Tertiary text-link CTAs use shelf-brown foreground with underline-on-hover.",
+    card:
+      "Show-tile is the canonical card — square artwork at 1:1, generously rounded (1rem), with title and host below, lifted by .tile-soft shadow that grows to .tile-lift on hover. " +
+      "Episode cards use bg-card (white) on cream background, p-5 lg:p-6, with chapter-list inside when expanded. " +
+      "No card uses cream fill — cards always sit above the canvas in white.",
+    input:
+      "Pill-shape (rounded-full) input with bg-card, 1px --border, leading icon. " +
+      "Focus ring is 2px overcast-orange. Filter chips are rounded-full pills in bg-secondary with shelf-brown foreground; selected state shifts to castro-teal fill with white text.",
+    cta:
+      "Hero subscribe / listen CTA is a solid overcast-orange pill with white label, wrapped in subscribe-glow utility. " +
+      "App Store / Play Store badges for cross-platform CTAs. Tertiary links are foreground with underline-on-hover — never colored text-only.",
+  },
+
+  details: {
+    selectionBg: "hsl(var(--overcast-orange) / 0.28)",
+    selectionFg: "hsl(var(--foreground))",
+    focusRing: "2px solid hsl(var(--overcast-orange))",
+    scrollbarStyle: "thin",
+  },
+};

package/themes/publisher-indie/THEME.md

@@ -0,0 +1,78 @@
+# Design Direction — Publisher-Indie
+
+## Ethos
+Coffee House Press structured catalogue · Graywolf serif gravity · New Directions modernist pedigree · Tin House quarterly discipline · Two Dollar Radio small-press risk
+
+## Feel
+An independent literary publisher's spring catalogue. Deep cream paper, Source Serif throughout, forthcoming-titles listed with ISBN and pub-date the way a trade catalogue does. Color is almost absent — a single ink-navy used for series markers. Author headshots are tight black-and-white portraits, never marketing shots. The page reads with literary-fiction gravity, not bookstore warmth and not museum austerity — somewhere between.
+
+## Reference brands
+- **Coffee House Press** → structured catalogue list. Deep cream. Source Serif.
+- **Graywolf Press** → literary-fiction gravity, formal serif, ISBN-forward.
+- **New Directions** → modernist pedigree, numbered series, restrained color.
+- **Tin House** → quarterly publishing rhythm, masthead-style author bios.
+- **Two Dollar Radio** → small-press risk, hand-set catalogue feel.
+
+## Tokens
+Surface stack is **catalogue cream** (background) → **lighter cream** (card) → **deeper cream** (secondary/muted/accent). Hairline borders are warm gray (slightly cream-biased, never neutral). Brand tokens: `--ink`, `--cream`, `--ink-navy`, `--oxblood`.
+
+Primary is `--ink-navy`. Reserved for series markers, focus ring, and the single 'Subscribe' CTA. Oxblood is reserved for the fiction-genre tag — never elsewhere.
+
+## Typography
+- **Display:** Source Serif Pro (Graywolf / Coffee House catalogue serif). h1–h4.
+- **Body:** Source Serif Pro — single-family discipline. Body 17px / 1.68.
+- **Mono:** IBM Plex Mono. ISBN, pub-date, trim size — trade-catalogue mono.
+
+H1 uses `clamp(2.25rem, 5vw, 4.25rem)`. Forthcoming titles use the display serif italic at body+1 — like a catalogue subhead.
+
+## Spacing
+- **Container:** `max-w-5xl px-6 lg:px-12` — catalogue spread width.
+- **Sections:** hero `pt-24 pb-16 lg:pt-40 lg:pb-24`; default `py-20 lg:py-28`; tight `py-12 lg:py-18`.
+- **Scale:** 4 6 8 12 16 20 24 32 40 48 64 80 96 128.
+
+## Color
+No hex. Tokens only. Ink-navy is the only color used as fill (Subscribe button); everywhere else it's a hover state or a series-marker accent. Oxblood is reserved for the fiction-genre tag only. Cream and ink dominate every surface.
+
+## Radius
+`--radius: 0`. Sharp corners — catalogue pages are sharp. Pills disallowed.
+
+## Shadows
+**Minimal.** Two utilities: `.hairline-bottom` and `.catalogue-rule` (rules above + below for a listing row).
+
+## Motion
+Single keyframe: `fade-rise` (opacity + 20px translate, 1100ms). Print-publication settle. `prefers-reduced-motion` honored.
+
+## Component patterns
+- **Buttons:** text-link CTAs with ink-navy on hover. 'Subscribe' is the single solid-fill — ink-navy bg + cream text.
+- **Cards:** hairline rules top + bottom, no fill differentiation. Padding `p-7 lg:p-10`. Title in display serif italic; author in roman; metadata in mono.
+- **Inputs:** border-bottom only (1px ink). Label above in mono uppercase.
+- **CTA links:** ink → ink-navy on hover. Never a chip, never a gradient.
+
+## Recommended rich media
+Author portraits, black-and-white, tight crops — the way a publisher's catalogue shoots its authors. Environmental but not lifestyle: writer at a desk, on a porch, in a library. Never red-carpet, never event-PR. Cover plates are flat scans on cream paper, the way trade catalogues print them. Never 3D book mockups, never floating-cover renders.
+
+**AI tool recommendations:** **Midjourney / Flux** for portraits: *"black-and-white author portrait, environmental, soft window light, 50mm, Tri-X grain"*. For covers: *"book cover photographed flat on cream paper, neutral overhead lighting"*. Avoid AI gradients and "book stack" hero compositions.
+
+**Aspect ratios:** 4:5 portrait (author convention), 2:3 (cover convention). Never 16:9.
+
+**Captions** in mono. Format: *"Author Name · Forthcoming Title (Spring 2026) · ISBN 978-x-xxxxxx-xx-x"*.
+
+**Avoid:** marketing-style author shots, 3D book renders, gradients, decorative SVG, lifestyle stock.
+
+**Accessibility:** alt-text describes the portrait and the work — *"Black-and-white portrait: Catherine Lacey at her writing desk, facing window light."*
+
+## Component families
+- `ForthcomingTitle` family — list row with date + title + author + genre tag + ISBN.
+- `AuthorBio` family — portrait + name + recent title + 2-sentence bio.
+- `Subscription` family — tier card (NYRB-Subscription style, never SaaS pricing pillars).
+
+## Details
+- **Selection:** `hsl(var(--primary) / 0.18)` — ink-navy wash.
+- **Focus ring:** `1px solid hsl(var(--ring))`.
+- **Scrollbar:** thin.
+
+## Exceptions
+None yet.
+
+## Revisions
+- Initial direction.

package/themes/publisher-indie/tokens.ts

@@ -0,0 +1,148 @@
+import type { Direction } from "../schema";
+
+export const publisherIndie: Direction = {
+  name: "publisher-indie" as Direction["name"],
+  ethos:
+    "Coffee House Press structured catalogue · Graywolf serif gravity · New Directions modernist pedigree · Tin House quarterly discipline · Two Dollar Radio risk",
+  references: [
+    { brand: "Coffee House Press", trait: "structured catalogue list, deep cream, Source Serif" },
+    { brand: "Graywolf Press", trait: "literary-fiction gravity, formal serif, ISBN-forward listing" },
+    { brand: "New Directions", trait: "modernist pedigree, numbered series, restrained color" },
+    { brand: "Tin House", trait: "quarterly publishing rhythm, masthead-style author bios" },
+    { brand: "Two Dollar Radio", trait: "small-press risk, hand-set catalogue feel" },
+  ],
+  feel:
+    "An independent literary publisher's spring catalogue. Deep cream paper, Source Serif throughout, " +
+    "forthcoming-titles listed with ISBN and pub-date the way a trade catalogue does. " +
+    "Color is almost absent — a single ink-navy used for series markers. Author headshots are tight " +
+    "black-and-white portraits, never marketing shots.",
+
+  fonts: {
+    display: {
+      family: "Source Serif Pro",
+      fallback: ["Source Serif 4", "Cormorant Garamond", "Georgia", "serif"],
+      from: "Graywolf / Coffee House catalogue serif — modern transitional, readable at small sizes",
+      googleFont: "Source+Serif+Pro",
+      weights: [400, 600, 700],
+    },
+    body: {
+      family: "Source Serif Pro",
+      fallback: ["Source Serif 4", "Cormorant Garamond", "Georgia", "serif"],
+      from: "single-family discipline — body in the same serif, smaller, lighter",
+      googleFont: "Source+Serif+Pro",
+      weights: [400, 600],
+    },
+    mono: {
+      family: "IBM Plex Mono",
+      fallback: ["JetBrains Mono", "ui-monospace", "SFMono-Regular", "Consolas", "monospace"],
+      from: "ISBN, pub-date, trim size — trade-catalogue mono, slightly warmer than JetBrains",
+      googleFont: "IBM+Plex+Mono",
+      weights: [400, 500],
+    },
+  },
+
+  typography: {
+    headingTracking: "-0.012em",
+    bodyTracking: "0",
+    fontFeatureSettings: '"tnum", "calt", "kern"',
+    h1ScaleClamp: "clamp(2.25rem, 5vw, 4.25rem)",
+    bodyBaseSize: "1.0625rem",
+    bodyLineHeight: "1.68",
+  },
+
+  colors: {
+    background: { hsl: "36 28% 92%", from: "deep cream catalogue stock — Coffee House / Graywolf" },
+    foreground: { hsl: "220 22% 14%", from: "ink-navy black — printer's ink, never pure" },
+    card: { hsl: "36 32% 95%", from: "lighter cream — book-listing surface" },
+    popover: { hsl: "36 32% 95%", from: "matches card" },
+    primary: { hsl: "220 50% 28%", from: "series-marker ink-navy — New Directions numbered-series feel" },
+    primaryForeground: { hsl: "36 28% 92%", from: "cream on ink-navy" },
+    secondary: { hsl: "36 22% 87%", from: "deeper cream — catalogue divider, masthead row" },
+    secondaryForeground: { hsl: "220 22% 14%", from: "ink on deeper cream" },
+    muted: { hsl: "36 22% 87%", from: "same as secondary" },
+    mutedForeground: { hsl: "220 12% 38%", from: "trade-catalogue gray — pub-dates, ISBNs" },
+    accent: { hsl: "36 20% 84%", from: "hover surface — cream deeper still" },
+    accentForeground: { hsl: "220 22% 14%", from: "ink on hover" },
+    border: { hsl: "30 12% 76%", from: "catalogue-page hairline, slightly warmer than gray" },
+    input: { hsl: "30 12% 76%", from: "same as border" },
+    ring: { hsl: "220 50% 28%", from: "ink-navy — focus" },
+    destructive: { hsl: "8 60% 42%", from: "out-of-print indicator" },
+    destructiveForeground: { hsl: "36 28% 92%", from: "cream on destructive" },
+    brand: {
+      ink: { hsl: "220 22% 14%", from: "printer's ink — semantic foreground" },
+      cream: { hsl: "36 28% 92%", from: "catalogue cream — semantic background" },
+      "ink-navy": { hsl: "220 50% 28%", from: "series-marker navy — also semantic primary" },
+      oxblood: { hsl: "0 45% 28%", from: "fiction-mark oxblood, used for fiction genre tag only" },
+    },
+  },
+
+  spacing: {
+    base: 4,
+    scale: [4, 6, 8, 12, 16, 20, 24, 32, 40, 48, 64, 80, 96, 128],
+    containerMax: "max-w-5xl",
+    containerPadding: "px-6 lg:px-12",
+    sectionPadding: {
+      hero: "pt-24 pb-16 lg:pt-40 lg:pb-24",
+      default: "py-20 lg:py-28",
+      tight: "py-12 lg:py-18",
+    },
+  },
+
+  radius: {
+    base: "0",
+    pillsAllowed: false,
+  },
+
+  shadows: {
+    style: "minimal",
+    utilities: {
+      "hairline-bottom":
+        "0 1px 0 0 hsl(var(--border))",
+      "catalogue-rule":
+        "0 1px 0 0 hsl(var(--border)), inset 0 1px 0 0 hsl(var(--border))",
+    },
+  },
+
+  motion: {
+    easing: "cubic-bezier(0.22, 1, 0.36, 1)",
+    durations: {
+      reveal: 1100,
+      loop: 4000,
+      ambient: 30000,
+    },
+    keyframes: {
+      "fade-rise": {
+        css:
+          "from { opacity: 0; transform: translateY(20px); }\n" +
+          "to { opacity: 1; transform: translateY(0); }",
+        defaultDuration: 1100,
+        iteration: "once",
+        purpose: "catalogue section entrance — print-publication settle",
+      },
+    },
+    respectsReducedMotion: true,
+  },
+
+  density: "medium",
+
+  patterns: {
+    button:
+      "Text-link CTAs with ink-navy on hover; 'Subscribe' is the single solid-fill — ink-navy bg + cream text. " +
+      "Pills disallowed — catalogue listings are rectangular.",
+    card:
+      "Hairline rules top + bottom, no fill differentiation from page. Padding p-7 lg:p-10. " +
+      "Title in display serif italic; author in display serif roman; metadata (ISBN, pub-date) in mono.",
+    input:
+      "Border-bottom only (1px ink). Label above in mono uppercase, small.",
+    cta:
+      "Text-link with ink, hover transitions to ink-navy. Never a chip. " +
+      "'Subscribe' is the single exception — solid ink-navy rectangle with cream text.",
+  },
+
+  details: {
+    selectionBg: "hsl(var(--primary) / 0.18)",
+    selectionFg: "hsl(var(--foreground))",
+    focusRing: "1px solid hsl(var(--ring))",
+    scrollbarStyle: "thin",
+  },
+};

package/themes/raw-concrete/BUILD_BRIEF.md

@@ -0,0 +1,157 @@
+# Raw-Concrete — Build Brief
+
+> The contract this theme ships with. Read at commit time by the
+> brief-enforcer subagent; handed to Claude Code via the Copy-for-Claude
+> button on the theme detail page.
+>
+> This theme is intentionally the LEAST polished theme in the library.
+> Its whole register is refusing polish. That means several rules in
+> the SLOP-BLOCKLIST are the OPPOSITE of what other themes forbid — do
+> NOT smooth this one into a modern SaaS composition.
+
+---
+
+## MANDATORY BUILD DIRECTIVE — you MUST
+
+1. **Radius 0 everywhere.** No `borderRadius: 4`, no `12`, no `999`,
+   no pill CTAs. Every button, every card, every input is a square.
+   The palette picker corners are `borderRadius: 0` too.
+2. **Box-shadow `none` everywhere.** Every card, every button, every
+   div. Depth is suggested by 1px `#C0C0C0` hairline borders, nothing
+   else.
+3. **Monospace family throughout the body.** `Berkeley Mono`,
+   `JetBrains Mono`, `Menlo` — one family. Body copy in mono at 14px
+   line-height 1.5. Headings in mono at slightly larger sizes but same
+   family. No display sans, no display serif.
+4. **Native `#0000EE` link color** on light canvas, `#8CB4FF` on dark.
+   Never override link color to match the palette accent. That IS the
+   theme's brand register.
+5. **Native `#551A8B` visited-link color** (dark canvas: `#D0ADF0`).
+   Users must be able to tell what they've already read.
+6. **Section numbers as `[01]`, `[02]`, `[03]`.** Every h2 opens with a
+   square-bracketed section number. This is the arxiv-preprint tell.
+7. **All images have visible captions** with `<figcaption>` in the
+   format `**fig. N.** <sentence>`. Never a photo without a caption.
+   This is the arxiv-figure register.
+
+---
+
+## SLOP-BLOCKLIST — you MUST NOT
+
+- **ANY border-radius > 0.** Pills, rounded cards, rounded buttons, all
+  banned. Fingerprint: `borderRadius: [1-9]` anywhere in the section.
+- **ANY box-shadow.** Fingerprint: `boxShadow:` with a non-`none`
+  value. No drop shadow, no glow, no elevation.
+- **ANY `transition:` on hover states.** Native links, native focus
+  rings, browser defaults only.
+- **Sans-serif or serif display fonts.** No Inter, no Fraunces, no
+  Bricolage. Monospace only.
+- **Override of the native link color.** The palette variant swaps
+  the LINK hue (that IS the theme's palette), but the CSS property
+  is always native link color, never a custom accent bg on a
+  span-as-link.
+- **Underline REMOVAL from links.** Every link stays underlined.
+- **Cycling headline words** or auto-advancing content.
+- **Purple/indigo/pink gradient backgrounds.** No gradients at all.
+- **CSS `filter:` treatments** on photos (no `brightness()`,
+  `contrast()`, `saturate()`). Photos rendered raw.
+- **Section-numbered content presented as marketing feature cards.**
+  Section `[01] Recent posts` is a numbered LIST, not a card grid.
+- **Roman-numeral copyright** (`MMXXVI`). Native `©` + Arabic year.
+- **Attribution of influence in visible copy** — vitalik.eth.limo,
+  arxiv.org, brutalistwebsites.com are studied but NEVER NAMED in
+  slug, copy, or UI.
+
+---
+
+## CHROME INVENTORY — the allow-list
+
+- **Sticky picker strip in native-link register** — canvas + link-color
+  pickers as underlined `[dark]` / `[light]` and `[default]` / `[kelp]`
+  bracket-prefixed links. NO button chrome. Body font (monospace).
+- **Table-based masthead nav** — `<table>` with 1px borderCollapse.
+  Left cell: `raw-concrete.txt` in bold. Right cell: 5-6 nav items as
+  underlined links separated by ` · `.
+- **Document masthead / [00] hero** — H1 in mono at 28px, weight 500;
+  1-3 paragraphs of body prose with inline underlined links; maintained
+  by / last-modified / content-type meta line (content-level `·` is
+  allowed here — it's arxiv-native).
+- **[N] Section headings** — h2 in mono at 18px, weight 500, prefixed
+  with `[01]`, `[02]`, etc. 1px underline via `borderBottom`.
+- **Numbered `<ol>` post lists** — indent 24px, mono body 14px.
+- **`<figure>` with photo + `<figcaption>`** — 1px black border on
+  image, caption below in mono 12px starting with `**fig. N.**`.
+- **`<table>` for spec + archive** — `borderCollapse: collapse`, 1px
+  border on every cell, mono 13px content, no zebra striping.
+- **`<blockquote>` for manifesto** — 3px left border, mono body 14px
+  in `normal` (not italic).
+- **Native `<input type="email">` + `<button>` for the subscribe
+  section.** No custom styling beyond 1px black border, radius 0.
+- **`©` copyright line in mono 12px.** No trademark ornaments.
+- **Palette picker labels use body font (monospace), sentence-case,
+  no textTransform.**
+
+---
+
+## SIGNATURE MOVES — verbs, not adjectives
+
+- **Number every section with `[NN]` in square brackets.** This is
+  the arxiv-preprint tell. The reader should feel they're reading a
+  document, not browsing an app.
+- **Set every link in `#0000EE` on cream** (or `#8CB4FF` on dark).
+  Visited links go `#551A8B`. Users must be able to tell what they've
+  already read. This is the ONE color that varies per palette.
+- **Wrap every image in `<figure>` with a `<figcaption>` starting
+  `fig. N.`** — never a bare `<img>`. If the image doesn't have a
+  caption, it doesn't belong on this theme.
+- **Use `<table>` for tabular data** — the spec table AND the archive
+  year list are real `<table>` elements with visible cell borders.
+  Refuse a `grid-cols-*` grid; this is the native-web tell.
+- **Render `<blockquote>` with a 3px left border** and mono body in
+  `fontStyle: "normal"` — NEVER italic. Italic blockquotes are the
+  Medium-blog register; the raw-concrete register is pre-CSS HTML.
+- **Sign off the colophon with an honest `view-source` link** — the
+  footer's last three links are `rss` + `atom` + `view-source` +
+  `colophon`. That IS the register.
+
+---
+
+## COLOR TOKENS
+
+**Light canvas** — `bg: #FFFFFF` / `ink: #000000` / `border: #C0C0C0`.
+Native link `#0000EE`, visited `#551A8B`.
+
+**Dark canvas** — `bg: #111111` / `ink: #E8E6E3` / `border: #404040`.
+Native link (per browser default in dark UA): `#8CB4FF` / visited
+`#D0ADF0`. This ISN'T pure black bg — the register is "dark browser
+default," not black-void.
+
+**Palette variant** — 10 link-color variants (default, kelp, vermilion,
+aubergine, ochre, cobalt, moss, ink, hazard, cyan). Only link + visited
+values change per palette. Everything else stays FIXED across variants.
+
+---
+
+## TYPOGRAPHY
+
+- **Display / body / mono:** ONE family. Berkeley Mono (fallback
+  JetBrains Mono, Menlo, Courier New). No secondary font.
+- **Sizes:** h1 = 28px weight 500; h2 = 18px weight 500 (with `[NN]`
+  prefix); body = 14px line-height 1.5; caption = 12px.
+
+---
+
+## SECTION SKELETON
+
+1. Sticky picker strip (native-link register).
+2. Table-based masthead nav.
+3. `[00]` Document masthead / hero.
+4. `[01]` Recent posts (numbered list).
+5. `[02]` Figures (3-up with captions).
+6. `[03]` Spec table.
+7. `[04]` Manifesto blockquote.
+8. `[05]` Fig. 4 full-bleed figure with caption.
+9. `[06]` Archive (year table).
+10. `[07]` Colophon (photo + text side-by-side).
+11. `[08]` Subscribe (native form).
+12. Footer with copyright + rss/atom/view-source/colophon links.

package/themes/raw-concrete/THEME.md

@@ -0,0 +1,76 @@
+# Raw Concrete
+
+> Web brutalism — system defaults weaponized, honest structure, monospace throughout.
+
+**Slug:** `raw-concrete` — **Surface:** web — **Density:** dense
+
+## Influence
+
+Web brutalism (brutalistwebsites.com era). Kate Moross print, Vitalik's blog, the original Craigslist, arxiv.org paper listings.
+
+## Signature move
+
+Every link is `#0000EE`. Every visited link is `#551A8B`. Every border is a
+`1px solid #C0C0C0` hairline. No border-radius anywhere — every corner is
+90°. No box-shadow ever. Tables render as tables (visible cell borders).
+Buttons look like `<button>` elements pre-CSS. Underlines on links stay.
+The composition is unmistakably "the browser did this, not a designer."
+
+## Palette
+
+- **bg:** `#FFFFFF`
+- **surface:** `#FFFFFF`
+- **ink:** `#000000`
+- **accent:** `#0000EE`
+- **secondary:** `#C0C0C0`
+
+## Typography
+
+- **Display:** Berkeley Mono (paid) or JetBrains Mono (free) — 500 weight for headings, no display face beyond this
+- **Body:** same as display — Berkeley Mono or JetBrains Mono, 400 weight, 15px
+- **Mono:** same as display and body — the whole theme is monospace, one family, three weights
+- **Scale:** 1.2 (minor third — deliberately shallow contrast; body and heading feel close)
+
+## Motion
+
+none — no transitions, no scroll reveals, no hover animations. The absence IS the register.
+
+## Imagery
+
+Photographs render at native aspect ratio with a 1px black border and no
+cropping. No filters, no gradients, no vignettes. Illustrations are ASCII
+or single-color line drawings. No 3D, no rendered shapes, no icons beyond
+what unicode provides.
+
+## Best for
+
+- Personal blogs (Vitalik-register)
+- Academic paper listings (arxiv-register)
+- Indie developer portfolios that want to feel earned
+- Manifestos and long-form essays
+- Art projects that trade on refusal-of-polish
+- Craigslist-shaped marketplaces
+
+## Reject if
+
+_Director grades each of the following as a pass/fail check. Any violation blocks the theme._
+
+- Border-radius greater than 0px anywhere on the page
+- Any box-shadow — hover, focus, or decorative
+- CSS transitions or animations of any kind
+- Prettified link colors — links must render as browser-default #0000EE
+- Sans-serif or serif faces — monospace only, one family throughout
+- Rounded buttons or pill-shaped controls
+- Gradient backgrounds or gradient text
+- Icon fonts or SVG icons — unicode symbols only (▲ ▼ · × → ←)
+- Padding standardization — deliberately inconsistent, exposed structure
+- Hover states other than the browser default underline / link-color-change
+
+## Banned defaults (inherited + theme-specific)
+
+- claude-cream (#F4F1EA + serif + #D97757)
+- void+acid (near-black bg + single bright acid-green or vermilion accent)
+- broadsheet-on-noneditorial (hairline rules + zero border-radius + newspaper columns on non-editorial content)
+- tech-bro purple gradient (purple→blue gradient hero + centered headline + double CTA + emoji icons)
+- uniform-everything (identical padding + one weight of one sans doing every job + rounded-2xl + shadow-md cards)
+- brutalism-as-decoration (visible borders + monospace applied as decoration to an otherwise polished SaaS layout — Raw Concrete must refuse polish structurally, not aesthetically)

package/themes/raw-concrete/tailwind.snippet.ts

@@ -0,0 +1,16 @@
+// Generated from theme.yml. Merge into your tailwind.config.ts under theme.extend.
+// slug: raw-concrete
+export const rawConcreteTailwindExtend = {
+  colors: {
+    bg: "#FFFFFF",
+    surface: "#FFFFFF",
+    ink: "#000000",
+    accent: "#0000EE",
+    secondary: "#C0C0C0",
+  },
+  fontFamily: {
+    display: ["Berkeley Mono (paid) or JetBrains Mono (free) — 500 weight for headings, no display face beyond this"],
+    body: ["same as display — Berkeley Mono or JetBrains Mono, 400 weight, 15px"],
+    mono: ["same as display and body — the whole theme is monospace, one family, three weights"],
+  },
+};