Packs docs/packs/syntax/aesthetic.md
Syntax Pack — Channel Aesthetic #
The brand source of truth is the live overlay system: github.com/randyrektor/syntax-overlay (ratified 2026-07-09). Everything the channel draws on screen follows that system. The previous version of this doc described a "torn-paper zine collage" voice — that was a misrepresentation of the brand and drove the corpus toward glossy/collage template looks; it is retired. Where this doc and the repo disagree, the repo wins.
This doc governs the Syntax Pack — one Pack of many. Nothing here is an engine rule; the engine stays general (quality/animation rubrics are aesthetic-neutral).
Channel Voice #
- Flat, physical, decisive. Cards are flat surfaces with visible borders and a chunky stepped shadow — like matte cardstock laid on a desk under hard light. Never glossy: no gradients-as-atmosphere, no lens flares, no glow, no gaussian ambience.
- Opinionated and direct. The overlay states the point. No hedged copy, no "in this video we'll explore."
- Warm dark, one loud yellow. Warm near-blacks carry the frame;
#ffd54ayellow is the single loud voice, used decisively (a chip, a separator, an active cue) — not sprayed. - Mono chrome voice. Space Mono is the channel's interface voice — tags, labels, kickers, tickers, stamps. Space Grotesk is the display voice — names, titles.
- Substrate ≠ chrome. A found document (newspaper, tweet, research paper, photo) keeps its own physics — that's verisimilitude. Everything the channel adds on top (cards, chips, tickers, lower-thirds, diagram strokes) is this flat-card system.
Palette #
The repo's tokens, verbatim. These are the channel colors — deviate only inside a found-document substrate that carries its own ink.
| Token | Value | Use |
|---|---|---|
| Background | #0e0e0d |
Full-frame fields, dark substrates |
| Card | #141413 |
Card/plate surfaces |
| Border | #454441 |
Card borders (2px at 1080 / 4px at 4K) |
| Shadow | #050504 |
The stepped shadow stack |
| Accent | #ffd54a |
THE yellow: chips, separators, active cues, focus |
| Success | #3dd816 |
Positive marks, live/on-air cues |
| Danger | #ff474e |
Negative marks, alerts, the pulse dot |
| Text | #f7f6f2 |
Primary ink on dark |
| Byline | #c9c6bc |
Secondary text on cards |
| Muted | #8a8883 |
Tertiary/chrome labels |
| Ink-on-yellow | #0a0a09 |
Text on accent plates |
Saturated-hue cap (Q4) still binds: ≤ 3 saturated hues visible at once — yellow is the default single slot; green/red enter only with a semantic job.
Never: pastels, purple-tinted substrates, pure RGB primaries, Apple-keynote gradient washes, amber-warm "cinematic" tints (#f4a85e-family reads as generic template, not Syntax).
Marks are the one exception: the physical highlighter/pen marks drawn over document substrates keep their measured-from-footage colors (highlighter #fabf47 ~0.62 alpha — see the web-document canon). A highlighter is a pen on the document, not channel chrome.
Type System #
Two faces, fixed jobs (Q18's 2-family cap holds; a found-document substrate carrying its own face is the only third):
- Space Grotesk — display: names, titles, headlines on cards. 700 for primary (tight,
-0.02em), 500 for supporting. - Space Mono — chrome: kickers, tags, tickers, stamps, diagram labels, code. 700 uppercase
.08emon chips; 400 for quiet labels.
Both self-hosted via @fontsource in src/lib/packs/syntax/fonts.ts. (Operator Mono is retired from this doc — the repo uses Space Mono.)
The Card System #
The signature construction, from the repo (values ×2 for the 4K frame):
- Plate:
#141413, fully opaque. Never a scrim gradient. - Border:
4px solid #454441(4K). Always visible — the border is part of the look. - Radius:
16px(4K). Corners round; they do not tear. - The stepped shadow: ten stacked hard offsets,
2px 2px 0 0 #050504through20px 20px 0 0 #050504(4K). This is THE depth treatment — flat, physical, unmistakable. No gaussian shadows on chrome, ever. - Type on the card: Grotesk 700 title in
#f7f6f2, byline in#c9c6bc, optional Space Mono kicker in#ffd54aabove. - Avatar treatment (when a piece carries one): the portrait bleeds outside the card boundary, hard drop-shadowed (
3px 4px 0dark + a 1px light lip) — same flat physics.
Chrome Vocabulary #
- Chip / tag:
#ffd54aplate,#0a0a09ink, Space Mono 700 uppercase.08em, square-ish with the system radius,2px #0a0a09divider when butted against content. (The ticker tag is the canonical chip.) - Pulse dot:
#ff474ecircle with an opacity/box-shadow pulse — the "live" cue. - Separator: the yellow diamond
◆between ticker items. - Bars/tickers: full-width flex bars on the card construction (border + stepped shadow), content scrolling linear.
Diagram strokes #
Clean printed rules — wobble: 0. Scribbly/hand-jitter strokes are not the channel's line quality (distinct from the torn-paper question; both retired 2026-07-09). Stroke color rides the composition ink; accent-inked elements (ink: 'accent') go #ffd54a.
Substrate Vocabulary #
The found documents the channel quotes. Substrates are verisimilar artifacts — they keep their own physics and typography (a tweet looks exactly like Twitter; a newspaper looks like newsprint). The channel layer over them is the card system above.
- Web documents (Twitter/Reddit/GitHub/YouTube/news/iMessage): pixel-faithful mocks (see ADR-0030/0031 and the web-document canon).
- Paper documents (research paper, newspaper, letter): real print physics — their own serif/slab faces, their own ink. The newspaper is photographed, not clipped: a full-bleed crop into a grey broadsheet page — folio line and heavy rule, tight bold grotesque headline, bold-caps byline, justified serif columns with column rules, lens vignette, grain, soft corners — with one highlighter stroke as the only mark and no page edge ever in shot (
ADR-0056; plates indocs/inspo/newspaper/). Torn edges remain plausible on the other physical documents being quoted; they are not channel chrome and never appear on cards/chips/lower-thirds. - Photographs: real photographic substrates, vignetted for legibility where text rides them; the photo must remain readable AS a photo (R2 substrate-resolution rule).
- Marks on substrates: highlighter/underline/circle are physical pens on the document — hand energy lives HERE (stroke-draw, slight wobble, overshoot), and only here.
- Tape is a dressing, not chrome (Scott, 2026-07-09): the washi-tape capability stays in the engine as a feature, but under Syntax it may only appear as dressing on a quoted physical document (a taped-down clipping). A standalone tape chip is not the brand.
Motion Vocabulary #
The repo's motion is fast, decisive, flat — enter ~420ms strong decelerate, exit ~350ms accelerate (G6-compatible). Preferences:
Lean in:
- settled-place for cards (small overshoot = "placed with intent").
- stroke-draw for marks and diagram rules (ink saturates along the path).
- brightness-reveal for spoken-content text over substrates.
- counter/ticker rolls for numbers (the odometer is on-brand chrome).
- Chip pop — a chip lands slightly late after its card,
sharp.
Lean out (wrong for this channel):
- Anamorphic flares, glows, light sweeps — all gloss.
- Gaussian-blur atmosphere; soft photographic shadows on chrome.
- Full-frame camera moves on chrome compositions (substrate/depth pieces may camera; a ticker never does).
- Bouncy ease on factual content; typewriter pop-in per word.
Anti-Aesthetic #
Reads wrong for this channel specifically:
- Gloss of any kind — scrim gradients, flares, rim glows, glassy plates. The channel is matte.
- Torn-paper / zine-collage chrome — retired misrepresentation. Tears may exist only inside a quoted physical document.
- Scribbly/wobbly line work on chrome or diagrams — hand energy belongs to marks on documents only.
- Pastel or amber-warm "cinematic" palettes — the warm blacks + one loud yellow are the identity.
- Purple-tinted substrates — not in the brand system.
- Compositions with no mono — Space Mono chrome is the signature thread.
- Gaussian shadows on cards — the stepped stack IS the depth treatment.
- Generic stock motion-template moves — swooshes, glassy wipes, light leaks.
When in doubt: would this pass as a native element of the syntax-overlay live system?
Reference Reel #
| Source | Take from it |
|---|---|
syntax-overlay lower-thirds.html |
The card: plate, border, radius, stepped shadow, Grotesk/byline hierarchy, avatar bleed |
syntax-overlay ticker.html |
The chip/tag, pulse dot, diamond separators, bar construction, motion curves |
syntax-overlay featured-comment.html |
Quoting external content inside the card system |
docs/inspo/newspaper/*.png |
Substrate physics for quoted print documents (substrate, not chrome) |
docs/inspo/pullquote/*.png |
Text-over-photo reveals (substrate register) |