diff --git a/packages/starpod/.impeccable/config.json b/packages/starpod/.impeccable/config.json
new file mode 100644
index 0000000..747d7b3
--- /dev/null
+++ b/packages/starpod/.impeccable/config.json
@@ -0,0 +1,3 @@
+{
+ "buildPath": "code"
+}
diff --git a/packages/starpod/.impeccable/design.json b/packages/starpod/.impeccable/design.json
new file mode 100644
index 0000000..e2634de
--- /dev/null
+++ b/packages/starpod/.impeccable/design.json
@@ -0,0 +1,820 @@
+{
+ "schemaVersion": 2,
+ "generatedAt": "2026-11-14T02:36:56.672077+00:00",
+ "title": "Design System: Starpod",
+ "extensions": {
+ "colorMeta": {
+ "iris-100": {
+ "role": "primary",
+ "displayName": "Iris Wash",
+ "canonical": "oklch(95% 0.022 293)",
+ "tonalRamp": [
+ "oklch(45.5% 0.2 291)",
+ "oklch(59.6% 0.22 292)",
+ "oklch(77.32% 0.129 294.81)",
+ "oklch(86.9% 0.07 293.5)",
+ "oklch(95% 0.022 293)"
+ ]
+ },
+ "iris-200": {
+ "role": "primary",
+ "displayName": "Pale Iris",
+ "canonical": "oklch(86.9% 0.07 293.5)",
+ "tonalRamp": [
+ "oklch(45.5% 0.2 291)",
+ "oklch(59.6% 0.22 292)",
+ "oklch(77.32% 0.129 294.81)",
+ "oklch(86.9% 0.07 293.5)",
+ "oklch(95% 0.022 293)"
+ ]
+ },
+ "iris-300": {
+ "role": "primary",
+ "displayName": "Lilac",
+ "canonical": "oklch(77.32% 0.129 294.81)",
+ "tonalRamp": [
+ "oklch(45.5% 0.2 291)",
+ "oklch(59.6% 0.22 292)",
+ "oklch(77.32% 0.129 294.81)",
+ "oklch(86.9% 0.07 293.5)",
+ "oklch(95% 0.022 293)"
+ ]
+ },
+ "iris-500": {
+ "role": "primary",
+ "displayName": "Iris",
+ "canonical": "oklch(59.6% 0.22 292)",
+ "tonalRamp": [
+ "oklch(45.5% 0.2 291)",
+ "oklch(59.6% 0.22 292)",
+ "oklch(77.32% 0.129 294.81)",
+ "oklch(86.9% 0.07 293.5)",
+ "oklch(95% 0.022 293)"
+ ]
+ },
+ "iris-700": {
+ "role": "primary",
+ "displayName": "Deep Iris",
+ "canonical": "oklch(45.5% 0.2 291)",
+ "tonalRamp": [
+ "oklch(45.5% 0.2 291)",
+ "oklch(59.6% 0.22 292)",
+ "oklch(77.32% 0.129 294.81)",
+ "oklch(86.9% 0.07 293.5)",
+ "oklch(95% 0.022 293)"
+ ]
+ },
+ "aqua-100": {
+ "role": "secondary",
+ "displayName": "Aqua Mist",
+ "canonical": "oklch(95.5% 0.03 215)",
+ "tonalRamp": [
+ "oklch(48% 0.105 226)",
+ "oklch(77.5% 0.13 222)",
+ "oklch(91% 0.06 215)",
+ "oklch(95.5% 0.03 215)"
+ ]
+ },
+ "aqua-200": {
+ "role": "secondary",
+ "displayName": "Pale Aqua",
+ "canonical": "oklch(91% 0.06 215)",
+ "tonalRamp": [
+ "oklch(15% 0.06 215)",
+ "oklch(26% 0.06 215)",
+ "oklch(37% 0.06 215)",
+ "oklch(48% 0.06 215)",
+ "oklch(60% 0.06 215)",
+ "oklch(72% 0.06 215)",
+ "oklch(84% 0.06 215)",
+ "oklch(95% 0.06 215)"
+ ]
+ },
+ "aqua-400": {
+ "role": "secondary",
+ "displayName": "Aqua",
+ "canonical": "oklch(77.5% 0.13 222)",
+ "tonalRamp": [
+ "oklch(15% 0.13 222)",
+ "oklch(26% 0.13 222)",
+ "oklch(37% 0.13 222)",
+ "oklch(48% 0.13 222)",
+ "oklch(60% 0.13 222)",
+ "oklch(72% 0.13 222)",
+ "oklch(84% 0.13 222)",
+ "oklch(95% 0.13 222)"
+ ]
+ },
+ "aqua-700": {
+ "role": "secondary",
+ "displayName": "Deep Aqua",
+ "canonical": "oklch(48% 0.105 226)",
+ "tonalRamp": [
+ "oklch(15% 0.105 226)",
+ "oklch(26% 0.105 226)",
+ "oklch(37% 0.105 226)",
+ "oklch(48% 0.105 226)",
+ "oklch(60% 0.105 226)",
+ "oklch(72% 0.105 226)",
+ "oklch(84% 0.105 226)",
+ "oklch(95% 0.105 226)"
+ ]
+ },
+ "ground-day": {
+ "role": "neutral",
+ "displayName": "Ground (day)",
+ "canonical": "oklch(97.65% 0.005 274.97)",
+ "tonalRamp": [
+ "oklch(15% 0.005 274.97)",
+ "oklch(26% 0.005 274.97)",
+ "oklch(37% 0.005 274.97)",
+ "oklch(48% 0.005 274.97)",
+ "oklch(60% 0.005 274.97)",
+ "oklch(72% 0.005 274.97)",
+ "oklch(84% 0.005 274.97)",
+ "oklch(95% 0.005 274.97)"
+ ]
+ },
+ "surface-day": {
+ "role": "neutral",
+ "displayName": "Surface (day)",
+ "canonical": "oklch(99.6% 0.002 280)",
+ "tonalRamp": [
+ "oklch(15% 0.002 280)",
+ "oklch(26% 0.002 280)",
+ "oklch(37% 0.002 280)",
+ "oklch(48% 0.002 280)",
+ "oklch(60% 0.002 280)",
+ "oklch(72% 0.002 280)",
+ "oklch(84% 0.002 280)",
+ "oklch(95% 0.002 280)"
+ ]
+ },
+ "raised-day": {
+ "role": "neutral",
+ "displayName": "Raised (day)",
+ "canonical": "oklch(95.2% 0.01 280)",
+ "tonalRamp": [
+ "oklch(15% 0.01 280)",
+ "oklch(26% 0.01 280)",
+ "oklch(37% 0.01 280)",
+ "oklch(48% 0.01 280)",
+ "oklch(60% 0.01 280)",
+ "oklch(72% 0.01 280)",
+ "oklch(84% 0.01 280)",
+ "oklch(95% 0.01 280)"
+ ]
+ },
+ "line-day": {
+ "role": "neutral",
+ "displayName": "Line (day)",
+ "canonical": "oklch(90.5% 0.014 280)",
+ "tonalRamp": [
+ "oklch(15% 0.014 280)",
+ "oklch(26% 0.014 280)",
+ "oklch(37% 0.014 280)",
+ "oklch(48% 0.014 280)",
+ "oklch(60% 0.014 280)",
+ "oklch(72% 0.014 280)",
+ "oklch(84% 0.014 280)",
+ "oklch(95% 0.014 280)"
+ ]
+ },
+ "line-strong-day": {
+ "role": "neutral",
+ "displayName": "Line Strong (day)",
+ "canonical": "oklch(83% 0.02 280)",
+ "tonalRamp": [
+ "oklch(15% 0.02 280)",
+ "oklch(26% 0.02 280)",
+ "oklch(37% 0.02 280)",
+ "oklch(48% 0.02 280)",
+ "oklch(60% 0.02 280)",
+ "oklch(72% 0.02 280)",
+ "oklch(84% 0.02 280)",
+ "oklch(95% 0.02 280)"
+ ]
+ },
+ "ink-day": {
+ "role": "neutral",
+ "displayName": "Ink (day)",
+ "canonical": "oklch(24% 0.05 292)",
+ "tonalRamp": [
+ "oklch(15% 0.05 292)",
+ "oklch(26% 0.05 292)",
+ "oklch(37% 0.05 292)",
+ "oklch(48% 0.05 292)",
+ "oklch(60% 0.05 292)",
+ "oklch(72% 0.05 292)",
+ "oklch(84% 0.05 292)",
+ "oklch(95% 0.05 292)"
+ ]
+ },
+ "text-day": {
+ "role": "neutral",
+ "displayName": "Text (day)",
+ "canonical": "oklch(37% 0.034 288)",
+ "tonalRamp": [
+ "oklch(15% 0.034 288)",
+ "oklch(26% 0.034 288)",
+ "oklch(37% 0.034 288)",
+ "oklch(48% 0.034 288)",
+ "oklch(60% 0.034 288)",
+ "oklch(72% 0.034 288)",
+ "oklch(84% 0.034 288)",
+ "oklch(95% 0.034 288)"
+ ]
+ },
+ "muted-day": {
+ "role": "neutral",
+ "displayName": "Muted (day)",
+ "canonical": "oklch(49% 0.026 286)",
+ "tonalRamp": [
+ "oklch(15% 0.026 286)",
+ "oklch(26% 0.026 286)",
+ "oklch(37% 0.026 286)",
+ "oklch(48% 0.026 286)",
+ "oklch(60% 0.026 286)",
+ "oklch(72% 0.026 286)",
+ "oklch(84% 0.026 286)",
+ "oklch(95% 0.026 286)"
+ ]
+ },
+ "on-ink-day": {
+ "role": "neutral",
+ "displayName": "On Ink (day)",
+ "canonical": "oklch(98.5% 0.006 290)",
+ "tonalRamp": [
+ "oklch(15% 0.006 290)",
+ "oklch(26% 0.006 290)",
+ "oklch(37% 0.006 290)",
+ "oklch(48% 0.006 290)",
+ "oklch(60% 0.006 290)",
+ "oklch(72% 0.006 290)",
+ "oklch(84% 0.006 290)",
+ "oklch(95% 0.006 290)"
+ ]
+ },
+ "accent-soft-night": {
+ "role": "secondary",
+ "displayName": "Night Accent Wash",
+ "canonical": "oklch(26% 0.05 225)",
+ "tonalRamp": [
+ "oklch(15% 0.05 225)",
+ "oklch(26% 0.05 225)",
+ "oklch(37% 0.05 225)",
+ "oklch(48% 0.05 225)",
+ "oklch(60% 0.05 225)",
+ "oklch(72% 0.05 225)",
+ "oklch(84% 0.05 225)",
+ "oklch(95% 0.05 225)"
+ ]
+ },
+ "ground-night": {
+ "role": "neutral",
+ "displayName": "Ground (night)",
+ "canonical": "oklch(13.85% 0.025 273.24)",
+ "tonalRamp": [
+ "oklch(15% 0.025 273.24)",
+ "oklch(26% 0.025 273.24)",
+ "oklch(37% 0.025 273.24)",
+ "oklch(48% 0.025 273.24)",
+ "oklch(60% 0.025 273.24)",
+ "oklch(72% 0.025 273.24)",
+ "oklch(84% 0.025 273.24)",
+ "oklch(95% 0.025 273.24)"
+ ]
+ },
+ "surface-night": {
+ "role": "neutral",
+ "displayName": "Surface (night)",
+ "canonical": "oklch(17.4% 0.025 277)",
+ "tonalRamp": [
+ "oklch(15% 0.025 277)",
+ "oklch(26% 0.025 277)",
+ "oklch(37% 0.025 277)",
+ "oklch(48% 0.025 277)",
+ "oklch(60% 0.025 277)",
+ "oklch(72% 0.025 277)",
+ "oklch(84% 0.025 277)",
+ "oklch(95% 0.025 277)"
+ ]
+ },
+ "raised-night": {
+ "role": "neutral",
+ "displayName": "Raised (night)",
+ "canonical": "oklch(21.57% 0.029 280.68)",
+ "tonalRamp": [
+ "oklch(15% 0.029 280.68)",
+ "oklch(26% 0.029 280.68)",
+ "oklch(37% 0.029 280.68)",
+ "oklch(48% 0.029 280.68)",
+ "oklch(60% 0.029 280.68)",
+ "oklch(72% 0.029 280.68)",
+ "oklch(84% 0.029 280.68)",
+ "oklch(95% 0.029 280.68)"
+ ]
+ },
+ "line-night": {
+ "role": "neutral",
+ "displayName": "Line (night)",
+ "canonical": "oklch(25.5% 0.035 272)",
+ "tonalRamp": [
+ "oklch(15% 0.035 272)",
+ "oklch(26% 0.035 272)",
+ "oklch(37% 0.035 272)",
+ "oklch(48% 0.035 272)",
+ "oklch(60% 0.035 272)",
+ "oklch(72% 0.035 272)",
+ "oklch(84% 0.035 272)",
+ "oklch(95% 0.035 272)"
+ ]
+ },
+ "line-strong-night": {
+ "role": "neutral",
+ "displayName": "Line Strong (night)",
+ "canonical": "oklch(33% 0.045 274)",
+ "tonalRamp": [
+ "oklch(15% 0.045 274)",
+ "oklch(26% 0.045 274)",
+ "oklch(37% 0.045 274)",
+ "oklch(48% 0.045 274)",
+ "oklch(60% 0.045 274)",
+ "oklch(72% 0.045 274)",
+ "oklch(84% 0.045 274)",
+ "oklch(95% 0.045 274)"
+ ]
+ },
+ "ink-night": {
+ "role": "neutral",
+ "displayName": "Ink (night)",
+ "canonical": "oklch(97.65% 0.005 274.97)",
+ "tonalRamp": [
+ "oklch(15% 0.005 274.97)",
+ "oklch(26% 0.005 274.97)",
+ "oklch(37% 0.005 274.97)",
+ "oklch(48% 0.005 274.97)",
+ "oklch(60% 0.005 274.97)",
+ "oklch(72% 0.005 274.97)",
+ "oklch(84% 0.005 274.97)",
+ "oklch(95% 0.005 274.97)"
+ ]
+ },
+ "text-night": {
+ "role": "neutral",
+ "displayName": "Text (night)",
+ "canonical": "oklch(83% 0.016 266)",
+ "tonalRamp": [
+ "oklch(15% 0.016 266)",
+ "oklch(26% 0.016 266)",
+ "oklch(37% 0.016 266)",
+ "oklch(48% 0.016 266)",
+ "oklch(60% 0.016 266)",
+ "oklch(72% 0.016 266)",
+ "oklch(84% 0.016 266)",
+ "oklch(95% 0.016 266)"
+ ]
+ },
+ "muted-night": {
+ "role": "neutral",
+ "displayName": "Muted (night)",
+ "canonical": "oklch(71% 0.02 264)",
+ "tonalRamp": [
+ "oklch(15% 0.02 264)",
+ "oklch(26% 0.02 264)",
+ "oklch(37% 0.02 264)",
+ "oklch(48% 0.02 264)",
+ "oklch(60% 0.02 264)",
+ "oklch(72% 0.02 264)",
+ "oklch(84% 0.02 264)",
+ "oklch(95% 0.02 264)"
+ ]
+ },
+ "on-ink-night": {
+ "role": "neutral",
+ "displayName": "On Ink (night)",
+ "canonical": "oklch(16% 0.03 270)",
+ "tonalRamp": [
+ "oklch(15% 0.03 270)",
+ "oklch(26% 0.03 270)",
+ "oklch(37% 0.03 270)",
+ "oklch(48% 0.03 270)",
+ "oklch(60% 0.03 270)",
+ "oklch(72% 0.03 270)",
+ "oklch(84% 0.03 270)",
+ "oklch(95% 0.03 270)"
+ ]
+ },
+ "media-ground-day": {
+ "role": "neutral",
+ "displayName": "Media Ground (day)",
+ "canonical": "oklch(19% 0.03 280)",
+ "tonalRamp": [
+ "oklch(15% 0.03 280)",
+ "oklch(26% 0.03 280)",
+ "oklch(37% 0.03 280)",
+ "oklch(48% 0.03 280)",
+ "oklch(60% 0.03 280)",
+ "oklch(72% 0.03 280)",
+ "oklch(84% 0.03 280)",
+ "oklch(95% 0.03 280)"
+ ]
+ },
+ "media-ground-night": {
+ "role": "neutral",
+ "displayName": "Media Ground (night)",
+ "canonical": "oklch(9% 0.02 273)",
+ "tonalRamp": [
+ "oklch(15% 0.02 273)",
+ "oklch(26% 0.02 273)",
+ "oklch(37% 0.02 273)",
+ "oklch(48% 0.02 273)",
+ "oklch(60% 0.02 273)",
+ "oklch(72% 0.02 273)",
+ "oklch(84% 0.02 273)",
+ "oklch(95% 0.02 273)"
+ ]
+ },
+ "on-media-chip": {
+ "role": "neutral",
+ "displayName": "On-Media Chip",
+ "canonical": "oklch(98% 0.005 285)",
+ "tonalRamp": [
+ "oklch(15% 0.005 285)",
+ "oklch(26% 0.005 285)",
+ "oklch(37% 0.005 285)",
+ "oklch(48% 0.005 285)",
+ "oklch(60% 0.005 285)",
+ "oklch(72% 0.005 285)",
+ "oklch(84% 0.005 285)",
+ "oklch(95% 0.005 285)"
+ ]
+ },
+ "on-media-ink": {
+ "role": "neutral",
+ "displayName": "On-Media Ink",
+ "canonical": "oklch(20% 0.04 285)",
+ "tonalRamp": [
+ "oklch(15% 0.04 285)",
+ "oklch(26% 0.04 285)",
+ "oklch(37% 0.04 285)",
+ "oklch(48% 0.04 285)",
+ "oklch(60% 0.04 285)",
+ "oklch(72% 0.04 285)",
+ "oklch(84% 0.04 285)",
+ "oklch(95% 0.04 285)"
+ ]
+ },
+ "media-glass": {
+ "role": "neutral",
+ "displayName": "Media Glass",
+ "canonical": "oklch(15% 0.02 280 / 0.72)",
+ "tonalRamp": [
+ "oklch(15% 0.02 280 / 0.72)"
+ ]
+ }
+ },
+ "typographyMeta": {
+ "display": {
+ "displayName": "Display",
+ "purpose": "Episode title on the stage; condensed uppercase Archivo, max 18ch."
+ },
+ "page-title": {
+ "displayName": "Page Title",
+ "purpose": "PageHeader on About, Contact, and other standalone pages."
+ },
+ "rail-title": {
+ "displayName": "Rail Title",
+ "purpose": "Show name in the desktop rail."
+ },
+ "headline": {
+ "displayName": "Headline",
+ "purpose": "Section titles: Show notes, Listen on, Meet the hosts."
+ },
+ "row-title": {
+ "displayName": "Row Title",
+ "purpose": "Episode titles in the list; current episode takes voice-0."
+ },
+ "body": {
+ "displayName": "Body",
+ "purpose": "UI text, tabular numerals."
+ },
+ "lede": {
+ "displayName": "Lede",
+ "purpose": "Paragraph under a page title, max 62ch."
+ },
+ "body-prose": {
+ "displayName": "Prose",
+ "purpose": "Show notes and transcripts (Tailwind prose)."
+ },
+ "label": {
+ "displayName": "Label",
+ "purpose": "Rail group labels, Presented by, Host/Guest tags."
+ },
+ "script-live-voice-0": {
+ "displayName": "Live Line, Voice 0",
+ "purpose": "The line being heard, first speaker."
+ },
+ "script-live-voice-1": {
+ "displayName": "Live Line, Voice 1",
+ "purpose": "The line being heard, second speaker, right-aligned."
+ },
+ "script-live-caption": {
+ "displayName": "Live Line, Caption",
+ "purpose": "The line being heard with no attributed speaker."
+ },
+ "script-rest": {
+ "displayName": "Script, Resting",
+ "purpose": "Lines away from the live one; size set by data-d."
+ }
+ },
+ "shadows": [
+ {
+ "name": "shadow-soft",
+ "value": "0 1px 2px oklch(28% 0.05 290 / 0.06), 0 10px 30px -12px oklch(28% 0.06 290 / 0.22)",
+ "purpose": "Stage frame, show art, mini-player chrome. Night: 0 1px 2px oklch(0% 0 0 / 0.3), 0 12px 32px -12px oklch(0% 0 0 / 0.6)."
+ },
+ {
+ "name": "shadow-float",
+ "value": "0 2px 6px oklch(20% 0.05 290 / 0.12), 0 24px 60px -18px oklch(20% 0.07 290 / 0.45)",
+ "purpose": "Artwork in the frame, stage play disc, bottom sheet, floating mini video. Night: 0 2px 8px oklch(0% 0 0 / 0.35), 0 28px 70px -18px oklch(0% 0 0 / 0.75)."
+ },
+ {
+ "name": "dock-lip",
+ "value": "0 -12px 32px -24px oklch(10% 0.03 280 / 0.5)",
+ "purpose": "Separates the fixed dock from content scrolling beneath."
+ }
+ ],
+ "motion": [
+ {
+ "name": "ease-out",
+ "value": "cubic-bezier(0.16, 1, 0.3, 1)",
+ "purpose": "State changes, reveals, sheets, page transitions, unfold."
+ },
+ {
+ "name": "ease-halo",
+ "value": "linear(0 0%, 0.0027 3.64%, 0.0106 7.29%, 0.0425 14.58%, 0.0957 21.87%, 0.1701 29.16%, 0.2477 35.19%, 0.3401 41.23%, 0.5982 55.18%, 0.7044 61.56%, 0.7987 68.28%, 0.875 75%, 0.9297 81.25%, 0.9687 87.5%, 0.9922 93.75%, 1 100%)",
+ "purpose": "The ring sweeping on over 500ms (animated @property --halo)."
+ },
+ {
+ "name": "ease-spring",
+ "value": "linear(0, 0.009, 0.035 2.1%, 0.141 4.4%, 0.723 12.9%, 0.938 16.7%, 1.017 19.4%, 1.067, 1.089 24.6%, 1.085 27.1%, 1.04 33.4%, 1.007 41.2%, 0.995 50.6%, 1.001 70.4%, 1)",
+ "purpose": "Press feedback, switch thumb, scrubber thumb, play glyph, mini-player scale."
+ },
+ {
+ "name": "fill",
+ "value": "300ms ease-out",
+ "purpose": "Solid controls fade into the gradient (--fill-a/--fill-b); icon gradient stops."
+ },
+ {
+ "name": "script-flip",
+ "value": "720ms cubic-bezier(0.25, 1, 0.5, 1)",
+ "purpose": "Live script lines FLIP to their new boxes; jumps over 3 lines crossfade."
+ },
+ {
+ "name": "page-curtain",
+ "value": "out 240ms cubic-bezier(0.4, 0, 1, 1); in 640ms ease-out",
+ "purpose": "View-transition curtain between pages; shell parts crossfade 180ms; dock never animates."
+ },
+ {
+ "name": "morph",
+ "value": "480ms ease-out",
+ "purpose": "List row art and title morph into the stage."
+ },
+ {
+ "name": "dock-in",
+ "value": "600ms ease-out",
+ "purpose": "Dock slides up once per visit."
+ },
+ {
+ "name": "unfold",
+ "value": "1000ms ease-out",
+ "purpose": "Foldable pages swing from rotateY(62deg) once on unfold."
+ },
+ {
+ "name": "reduced-motion",
+ "value": "1ms",
+ "purpose": "All animation and transition durations collapse under prefers-reduced-motion."
+ }
+ ],
+ "breakpoints": [
+ {
+ "name": "sm",
+ "value": "640px"
+ },
+ {
+ "name": "md",
+ "value": "768px"
+ },
+ {
+ "name": "lg",
+ "value": "1024px"
+ },
+ {
+ "name": "xl",
+ "value": "1100px"
+ },
+ {
+ "name": "foldable",
+ "value": "(horizontal-viewport-segments: 2), or coarse pointer 700-1180px wide at 6/5-8/5 aspect, max-height 960px"
+ }
+ ],
+ "glow": {
+ "day": [
+ "oklch(86.9% 0.07 293.5)",
+ "oklch(59.6% 0.22 292)"
+ ],
+ "night": [
+ "oklch(77.5% 0.13 222)",
+ "oklch(91% 0.06 215)"
+ ]
+ },
+ "engineState": [
+ "html: data-world=\"stage\" (fixed), data-medium (watch|listen), data-host (dock), data-has-video, data-episode, data-unfolding, data-arriving",
+ "stage: data-current, data-playing, data-watching, data-buffering",
+ "controls: data-buffering on .play-toggle, data-flash (keyboard acts as hover)",
+ "script lines: data-v (voice), data-d (distance), data-long, data-index",
+ "--playback-progress (0 to 1)"
+ ]
+ },
+ "components": [
+ {
+ "name": "Primary Button",
+ "kind": "button",
+ "refersTo": "button-primary",
+ "description": "Solid ink pill (Play episode, Send message); hover fades the fill into the Iris/Aqua gradient.",
+ "html": " Play episode ",
+ "css": ".ds-btn-primary { display: inline-flex; align-items: center; gap: 0.55rem; padding: 0.75rem 1.25rem; border: 0; border-radius: 999px; background: var(--ink, oklch(24% 0.05 292)); color: var(--on-ink, oklch(98.5% 0.006 290)); font: 700 0.9375rem/1 'Familjen Grotesk', ui-sans-serif, system-ui, sans-serif; cursor: pointer; transition: background 300ms cubic-bezier(0.16, 1, 0.3, 1), color 300ms cubic-bezier(0.16, 1, 0.3, 1), transform 300ms cubic-bezier(0.16, 1, 0.3, 1); } .ds-btn-primary:hover, .ds-btn-primary:focus-visible { background: linear-gradient(to right, var(--glow-a, oklch(86.9% 0.07 293.5)), var(--glow-b, oklch(59.6% 0.22 292))); color: var(--on-glow, oklch(24% 0.05 292)); outline: none; } .ds-btn-primary:active { transform: scale(0.97); }"
+ },
+ {
+ "name": "Secondary Button",
+ "kind": "button",
+ "refersTo": "button-secondary",
+ "description": "Outlined pill (Read the full transcript, Go back); wears the ring.",
+ "html": "Read the full transcript ",
+ "css": ".ds-ring { position: relative; isolation: isolate; } .ds-ring::after { content: ''; position: absolute; inset: -1px; border-radius: inherit; padding: 1px; background: linear-gradient(to bottom right, var(--glow-a, oklch(86.9% 0.07 293.5)), var(--glow-b, oklch(59.6% 0.22 292))); mask: linear-gradient(oklch(0% 0 0) 0 0) content-box, linear-gradient(oklch(0% 0 0) 0 0); mask-composite: exclude; -webkit-mask-composite: xor; opacity: 0; transition: opacity 500ms cubic-bezier(0.16, 1, 0.3, 1); pointer-events: none; } .ds-ring:hover::after, .ds-ring:focus-visible::after { opacity: 1; } .ds-btn-secondary { display: inline-flex; align-items: center; padding: 0.75rem 1.25rem; border: 1px solid var(--line-strong, oklch(83% 0.02 280)); border-radius: 999px; background: var(--surface, oklch(99.6% 0.002 280)); color: var(--ink, oklch(24% 0.05 292)); font: 700 0.9375rem/1 'Familjen Grotesk', ui-sans-serif, system-ui, sans-serif; cursor: pointer; } .ds-btn-secondary:focus-visible { outline: none; }"
+ },
+ {
+ "name": "Platform Pill",
+ "kind": "chip",
+ "refersTo": "platform-pill",
+ "description": "Labelled listen-on link with a muted platform glyph; wears the ring.",
+ "html": " RSS feed ",
+ "css": ".ds-ring { position: relative; isolation: isolate; } .ds-ring::after { content: ''; position: absolute; inset: -1px; border-radius: inherit; padding: 1px; background: linear-gradient(to bottom right, var(--glow-a, oklch(86.9% 0.07 293.5)), var(--glow-b, oklch(59.6% 0.22 292))); mask: linear-gradient(oklch(0% 0 0) 0 0) content-box, linear-gradient(oklch(0% 0 0) 0 0); mask-composite: exclude; -webkit-mask-composite: xor; opacity: 0; transition: opacity 500ms cubic-bezier(0.16, 1, 0.3, 1); pointer-events: none; } .ds-ring:hover::after, .ds-ring:focus-visible::after { opacity: 1; } .ds-platform { display: inline-flex; align-items: center; gap: 0.625rem; padding: 0.625rem 1.25rem 0.625rem 1rem; border: 1px solid var(--line, oklch(90.5% 0.014 280)); border-radius: 999px; color: var(--ink, oklch(24% 0.05 292)); font: 600 0.9375rem/1 'Familjen Grotesk', ui-sans-serif, system-ui, sans-serif; text-decoration: none; } .ds-platform svg { color: var(--muted, oklch(49% 0.026 286)); } .ds-platform:focus-visible { outline: none; }"
+ },
+ {
+ "name": "Medium Switch",
+ "kind": "custom",
+ "refersTo": "medium-switch",
+ "description": "Watch / Listen pill track with a sliding ink thumb.",
+ "html": "
Watch Listen
",
+ "css": ".ds-switch { position: relative; display: inline-grid; grid-template-columns: 1fr 1fr; padding: 3px; border: 1px solid oklch(83% 0.02 280); border-radius: 999px; background: oklch(97.65% 0.005 274.97); } .ds-switch-thumb { position: absolute; inset: 3px auto 3px 3px; width: calc(50% - 3px); border-radius: 999px; background: oklch(24% 0.05 292); transition: translate 520ms linear(0, 0.009, 0.035 2.1%, 0.141 4.4%, 0.723 12.9%, 0.938 16.7%, 1.017 19.4%, 1.067, 1.089 24.6%, 1.085 27.1%, 1.04 33.4%, 1.007 41.2%, 0.995 50.6%, 1.001 70.4%, 1); } .ds-switch:has(.ds-switch-opt:last-of-type[aria-checked='true']) .ds-switch-thumb { translate: 100% 0; } .ds-switch-opt { position: relative; z-index: 1; padding: 0.45rem 0.9rem; border: 0; border-radius: 999px; background: none; color: oklch(49% 0.026 286); font: 650 0.875rem/1 'Familjen Grotesk', ui-sans-serif, system-ui, sans-serif; cursor: pointer; transition: color 300ms cubic-bezier(0.16, 1, 0.3, 1); } .ds-switch-opt[aria-checked='true'] { color: oklch(98.5% 0.006 290); } .ds-switch-opt:focus-visible { outline: 2px solid oklch(59.6% 0.22 292); outline-offset: 3px; }"
+ },
+ {
+ "name": "Rail Navigation",
+ "kind": "nav",
+ "refersTo": "nav-item",
+ "description": "Rail and sheet links; current page in Accent Wash; config links pick their own icon.",
+ "html": "Now playing Episodes About ",
+ "css": ".ds-nav { display: flex; flex-direction: column; gap: 2px; width: 220px; } .ds-nav a { padding: 0.55rem 0.7rem; border-radius: 3px; color: oklch(37% 0.034 288); font: 600 1rem/1.3 'Familjen Grotesk', ui-sans-serif, system-ui, sans-serif; text-decoration: none; transition: background 200ms cubic-bezier(0.16, 1, 0.3, 1), color 200ms cubic-bezier(0.16, 1, 0.3, 1); } .ds-nav a:hover { background: oklch(95.2% 0.01 280); color: oklch(24% 0.05 292); } .ds-nav a[aria-current='page'] { background: oklch(95% 0.022 293); color: oklch(45.5% 0.2 291); } .ds-nav a:focus-visible { outline: 2px solid oklch(59.6% 0.22 292); outline-offset: 3px; }"
+ },
+ {
+ "name": "Row Play Disc",
+ "kind": "button",
+ "refersTo": "row-play",
+ "description": "Episode row play circle; wears the ring at rest, becomes a solid ink disc with on-air bars when current.",
+ "html": " ",
+ "css": ".ds-ring { position: relative; isolation: isolate; } .ds-ring::after { content: ''; position: absolute; inset: -1px; border-radius: inherit; padding: 1px; background: linear-gradient(to bottom right, var(--glow-a, oklch(86.9% 0.07 293.5)), var(--glow-b, oklch(59.6% 0.22 292))); mask: linear-gradient(oklch(0% 0 0) 0 0) content-box, linear-gradient(oklch(0% 0 0) 0 0); mask-composite: exclude; -webkit-mask-composite: xor; opacity: 0; transition: opacity 500ms cubic-bezier(0.16, 1, 0.3, 1); pointer-events: none; } .ds-ring:hover::after, .ds-ring:focus-visible::after { opacity: 1; } .ds-row-play { display: grid; place-items: center; width: 44px; height: 44px; border: 1px solid var(--line-strong, oklch(83% 0.02 280)); border-radius: 999px; background: var(--surface, oklch(99.6% 0.002 280)); color: var(--ink, oklch(24% 0.05 292)); cursor: pointer; } .ds-row-play:focus-visible { outline: none; }"
+ },
+ {
+ "name": "Seek Chip",
+ "kind": "chip",
+ "refersTo": "seek-chip",
+ "description": "HH:MM:SS timestamp in show notes and transcripts; fills with the gradient on hover; seeks on click.",
+ "html": "00:12:34 ",
+ "css": ".ds-seek-chip { display: inline-block; padding: 1px 0.375rem; border: 0; border-radius: 6px; background: var(--accent-soft, oklch(95% 0.022 293)); color: var(--accent-ink, oklch(45.5% 0.2 291)); font: 600 0.8125rem/1.4 'Familjen Grotesk', ui-sans-serif, system-ui, sans-serif; font-variant-numeric: tabular-nums; cursor: pointer; transition: background 300ms cubic-bezier(0.16, 1, 0.3, 1), color 300ms cubic-bezier(0.16, 1, 0.3, 1); } .ds-seek-chip:hover, .ds-seek-chip:focus-visible { background: linear-gradient(to right, var(--glow-a, oklch(86.9% 0.07 293.5)), var(--glow-b, oklch(59.6% 0.22 292))); color: var(--on-glow, oklch(24% 0.05 292)); outline: none; }"
+ },
+ {
+ "name": "Text Field",
+ "kind": "input",
+ "refersTo": "input",
+ "description": "Labelled field (Contact); accent border plus Accent Wash ring on focus, never an outline.",
+ "html": "Email ",
+ "css": ".ds-field { display: block; font: 400 1rem/1.5 'Familjen Grotesk', ui-sans-serif, system-ui, sans-serif; } .ds-field span { display: block; margin-bottom: 0.5rem; color: var(--ink, oklch(24% 0.05 292)); font-size: 0.875rem; font-weight: 600; } .ds-field input { display: block; width: 100%; padding: 0.75rem 1rem; border: 1px solid var(--line, oklch(90.5% 0.014 280)); border-radius: 12px; background: var(--surface, oklch(99.6% 0.002 280)); color: var(--ink, oklch(24% 0.05 292)); font: inherit; outline: none; transition: border-color 200ms cubic-bezier(0.16, 1, 0.3, 1), box-shadow 200ms cubic-bezier(0.16, 1, 0.3, 1); } .ds-field input::placeholder { color: var(--muted, oklch(49% 0.026 286)); } .ds-field input:focus { border-color: var(--accent, oklch(59.6% 0.22 292)); box-shadow: 0 0 0 4px var(--accent-soft, oklch(95% 0.022 293)); }"
+ },
+ {
+ "name": "Page Header",
+ "kind": "custom",
+ "refersTo": "page-title",
+ "description": "Condensed uppercase page title with a lede; opens About, Contact, and custom pages.",
+ "html": "",
+ "css": ".ds-page-header h1 { margin: 0; max-width: 18ch; color: var(--ink, oklch(24% 0.05 292)); font: 800 clamp(2.25rem, 1.4rem + 3vw, 4rem)/0.95 Archivo, 'Familjen Grotesk', ui-sans-serif, sans-serif; font-stretch: 72%; letter-spacing: -0.01em; text-transform: uppercase; text-wrap: balance; } .ds-page-header p { margin: 1.25rem 0 0; max-width: 62ch; color: var(--text, oklch(37% 0.034 288)); font: 400 1.125rem/1.625 'Familjen Grotesk', ui-sans-serif, system-ui, sans-serif; }"
+ },
+ {
+ "name": "Stage Live Script",
+ "kind": "custom",
+ "refersTo": "script-live-voice-0",
+ "description": "The conversation typeset by voice and distance: one face per speaker, live line at display size (night scheme shown).",
+ "html": "Right, and the first one was better. That is the whole point of the test Fair enough. ",
+ "css": ".ds-script { display: flex; flex-direction: column; gap: 14px; width: 460px; margin: 0; padding: 16px; list-style: none; background: oklch(13.85% 0.025 273.24); } .ds-l { line-height: 1.12; } .ds-l.v0 { color: oklch(77.32% 0.129 294.81); font-family: Archivo, 'Familjen Grotesk', sans-serif; font-stretch: 78%; font-weight: 750; max-width: 92%; } .ds-l.v1 { color: oklch(91% 0.06 215); font-family: 'Young Serif', Georgia, serif; margin-left: auto; text-align: right; max-width: 88%; } .ds-l.d0 { font-size: clamp(2.25rem, 1.2rem + 2.8vw, 3.5rem); font-stretch: 68%; font-weight: 900; text-transform: uppercase; line-height: 0.98; } .ds-l.d1 { font-size: 0.95rem; opacity: 0.38; } .ds-l.d2 { font-size: 1.15rem; opacity: 0.62; }"
+ }
+ ],
+ "narrative": {
+ "northStar": "The Typeset Conversation",
+ "overview": "**Creative North Star: \"The Typeset Conversation\"**\n\nA podcast is people talking, so Starpod typesets the conversation. The episode stage puts the video (or the show's artwork) beside a live script in which each voice has its own face, the line being heard swells to display size, and spoken lines shrink and soften back into the page. Everything else (the list of episodes, the shell, the pages) speaks in the same condensed, uppercase display voice and a calm grotesque for UI.\n\nOne engine runs the whole visit. A single persistent `` element plays the episode's HLS video or MP3, moves physically between the episode stage and the dock, and writes playback state onto `` and a live `--playback-progress` number so CSS can react without islands. Light and dark are both first-class: day uses Iris, night uses Aqua. The styles are still scoped under ``, which is hardcoded; there is one world.\n\nThe system is generic by construction. Show artwork and cast photos supply the only imagery colour, shown in full colour, and every surface has to look deliberate for any show's art.",
+ "keyCharacteristics": [
+ "One OKLCH palette, one shell, one Stage world.",
+ "Light is computed, not painted: the scrubber, the dock edge, and the stage light all take their position or colour from real playback.",
+ "Iris by day, Aqua by night. The accent marks interaction, current state, and playback, nothing else.",
+ "Three hover behaviours, never mixed: a gradient ring on outlined controls, a gradient fill on solid ones, a gradient icon on bare icons.",
+ "Condensed uppercase Archivo for every title; Familjen Grotesk for everything you read or operate.",
+ "Fixed navigation keeps play, follow, and navigation on screen at every size."
+ ],
+ "rules": [
+ {
+ "name": "The Two Lamps Rule",
+ "body": "Iris is the only accent by day and Aqua the only accent by night. Accent fills are limited to interaction, the current item, and playback, and never decorate resting content.",
+ "section": "colors"
+ },
+ {
+ "name": "The Computed Light Rule",
+ "body": "Every moving gradient or glow takes its position from `--playback-progress`, from sampled video, or from a hover/focus state. A gradient that no state drives does not belong in the system.",
+ "section": "colors"
+ },
+ {
+ "name": "The OKLCH Only Rule",
+ "body": "Every colour is authored in OKLCH, including shadows, masks, and backdrops. Hex and rgb are never used.",
+ "section": "colors"
+ },
+ {
+ "name": "The One Palette Rule",
+ "body": "Tailwind's theme holds only the token colours above. There are no parallel light/dark colour pairs; a single token class follows both schemes.",
+ "section": "colors"
+ },
+ {
+ "name": "The One Face Per Voice Rule",
+ "body": "In the script and the cast, voice 0 is condensed Archivo in the voice-0 colour, voice 1 is Young Serif in the voice-1 colour and right-aligned, and further voices or unattributed captions are Familjen in ink. A voice face always identifies a speaker.",
+ "section": "typography"
+ },
+ {
+ "name": "The Volume Rule",
+ "body": "Size, width, and opacity carry distance from the live line. They are set by the engine's `data-d` attribute and never by hand.",
+ "section": "typography"
+ },
+ {
+ "name": "The Upright Time Rule",
+ "body": "Every timestamp is upright, tabular, and in `HH:MM:SS` on seek chips.",
+ "section": "typography"
+ },
+ {
+ "name": "The Never-Hidden CTA Rule",
+ "body": "Play, follow, and navigation are fixed chrome at every size: the rail on desktop, the top bar plus tab bar plus dock below that. Page content pads for every fixed layer it could sit under.",
+ "section": "layout"
+ },
+ {
+ "name": "The Stage Light Rule",
+ "body": "The glow behind the stage frame is sampled from the playing video into a 32×18 canvas (artwork glow when nothing plays). It is the only ambient colour on the page and it is always computed.",
+ "section": "elevation"
+ },
+ {
+ "name": "The Two Shadows Rule",
+ "body": "Soft and Float are the only elevation shadows. A hover is shown by the ring, the gradient fill, or a Raised fill, never by a deeper shadow or a lift.",
+ "section": "elevation"
+ },
+ {
+ "name": "The Pill Controls Rule",
+ "body": "If it can be pressed, it is round. Corner radius on containers is near-square; corner radius on controls is full.",
+ "section": "shapes"
+ },
+ {
+ "name": "The Shape-Keeping Focus Rule",
+ "body": "Focus never changes an element's shape. The global ring is a 2px accent outline at 3px offset that follows the element's own radius; fields replace it with an accent border and a 4px Accent Wash ring.",
+ "section": "shapes"
+ },
+ {
+ "name": "The Three Hovers Rule",
+ "body": "Outlined controls draw the ring; solid controls fill with the gradient; bare icons turn the icon to the gradient. A control gets exactly one, and every one transitions.",
+ "section": "components"
+ }
+ ],
+ "dos": [
+ "**Do** read state from the engine: style `[data-current]`, `[data-playing]`, `[data-watching]`, `[data-buffering]`, `html[data-medium]`, `html[data-host]`, and `--playback-progress` instead of adding new JS-driven classes.",
+ "**Do** style new work with Tailwind utilities on the token colours; keep custom CSS for what Tailwind cannot express (`@property` animations, the ring, view transitions, voice typography).",
+ "**Do** choose the hover by the control's shape: ring for outlined, gradient fill for solid, gradient icon for bare icons, always with a transition.",
+ "**Do** use the easings: expo-out (`cubic-bezier(0.16, 1, 0.3, 1)`) for state and reveal, the `--ease-halo` curve for the ring, and the overshooting `linear()` spring for press, thumb, and glyph motion. Everything collapses to 1ms under `prefers-reduced-motion`.",
+ "**Do** open standalone pages with `PageHeader` and align them to the breadcrumbs.",
+ "**Do** give fields visible labels and the accent border plus Accent Wash ring on focus."
+ ],
+ "donts": [
+ "**Don't** author colour in hex, rgb, or hsl anywhere, including docs, shadows, and masks.",
+ "**Don't** reintroduce parallel light/dark Tailwind colours (`bg-light-*`, `dark:bg-dark-*`). Use the single token class.",
+ "**Don't** let an accent fill decorate resting content.",
+ "**Don't** reshape an element on focus or put a ring on a control that already fills or has no outline.",
+ "**Don't** add a third elevation shadow or a hover lift.",
+ "**Don't** desaturate or duotone show art or cast photos; show imagery in full colour.",
+ "**Don't** use a voice face (Archivo condensed as a speaker, Young Serif) for anything other than a speaker or their name; Archivo as a title face is fine.",
+ "**Don't** hide play, follow, or navigation behind scroll.",
+ "**Don't** add show-specific copy, colour, or imagery to the package. Show artwork and the site's own data are the only imagery and content sources."
+ ]
+ }
+}
diff --git a/packages/starpod/.impeccable/surfaces/src-layouts-layout-astro.md b/packages/starpod/.impeccable/surfaces/src-layouts-layout-astro.md
new file mode 100644
index 0000000..255e2e6
--- /dev/null
+++ b/packages/starpod/.impeccable/surfaces/src-layouts-layout-astro.md
@@ -0,0 +1,71 @@
+---
+version: 2
+slug: "src-layouts-layout-astro"
+primary_target: "src/layouts/Layout.astro"
+related_targets: ["src/pages/index.astro","src/pages/[episode].astro","src/pages/about.astro","src/pages/contact.astro","src/components/NotFoundContent.astro"]
+---
+
+# Surface brief: Starpod app shell (layout, home, episode, pages)
+
+Scope: the package Layout and every route it frames (home episode list,
+episode stage, about, contact, 404, custom pages). Mode: Experience on the
+episode stage (the video, or artwork plus audio, leads from the first
+viewport); Operate on the list and standalone pages.
+
+Audience/job: listeners and viewers of any Starpod show; start the episode in
+their chosen medium, subscribe, browse, read transcripts and show notes.
+Podcasters configure nothing for any of it beyond `starpod.config.ts`.
+
+Constraints (user-pinned): Iris (violet, light) / Aqua (cyan, dark) palette in
+OKLCH only; the gradient ring on outlined controls, gradient fill on solid
+ones, gradient icon on bare icons, always transitioned; app-scale single-show
+media experience; fixed navigation never hides CTAs; video-first, automatic
+from the feed's alternateEnclosure, artwork fallback for audio-only; video
+docks to a mini player across navigation; works on phone, desktop, and
+foldables, with a little delight just for foldables; keep every route and
+piece of metadata the site had (sitemap, llms.txt, .html.md twins, OpenAPI,
+schema, og:audio); Tailwind for styling, custom CSS only where Tailwind
+cannot express it; nothing show-specific in the package.
+
+## Decision
+
+Two directions were built for comparison as switchable worlds: Daylight
+Section (a building in section, poche walls, a light band) and Stage Page
+(the conversation typeset). The user chose **Stage**. Daylight was removed
+entirely (toggle, `?world=`, config, marks, rooms, shaft, limewash); `` is now hardcoded. DESIGN.md records the shipped system.
+
+## Direction contract — Stage Page (shipped)
+
+THESIS: A podcast is people talking, so the app typesets the conversation:
+each voice its own face, the line being spoken swelling as it is heard.
+Refuses the transcript-as-grey-paragraph and the static show-notes page.
+
+OWN-WORLD: One face per voice (condensed variable Archivo for voice 0 in Iris,
+Young Serif for voice 1 in Aqua, Familjen Grotesk for captions without
+speakers); size carries volume and lines recede as they pass; condensed
+uppercase Archivo for every title; calm Familjen UI; full-colour show art and
+cast photos; light sampled from the playing video.
+
+STORY: The home page is the episode list. Clicking a row morphs its art and
+title into the episode stage, where the conversation is already set beside
+the video. Pressing play makes the script perform in sync; clicking any line
+or timestamp seeks; the dock carries playback across pages; the rail (or top
+bar, tab bar, and More sheet) keeps follow and navigation visible.
+
+FIRST VIEWPORT (episode): Desktop: rail left with the show name set large;
+stage column (video or artwork, title, facts, cast, sponsors, Watch/Listen,
+Play) beside a sticky script column with the live line at ~3.5rem and prior
+lines shrinking upward; dock bottom. Phones: picture, then script, then meta.
+Primary action: play on the stage.
+
+STANDALONE PAGES: `PageHeader` (condensed uppercase title plus lede) aligned
+to the breadcrumbs. About: Listen on (labelled platform pills), Meet the hosts
+(two columns, large portraits, bio, links). Contact: labelled fields, accent
+focus, sending/sent/error states. 404: illustration, heading, helpful links,
+Go back.
+
+SIGNATURES: the live script (FLIP between lines); stage light sampled into a
+32×18 canvas; scrubber transcript preview; list-to-stage morph; curtain page
+transitions; on-air bars on the current row; keyboard shortcuts (K, J, L, M,
+W, F). Foldable: two voices argue across the hinge; the stage unfolds once.
diff --git a/packages/starpod/DESIGN.md b/packages/starpod/DESIGN.md
new file mode 100644
index 0000000..cc71ef9
--- /dev/null
+++ b/packages/starpod/DESIGN.md
@@ -0,0 +1,396 @@
+---
+name: Starpod
+description: A video-first podcast app generated from one RSS feed, typeset as a conversation.
+colors:
+ iris-100: "oklch(95% 0.022 293)"
+ iris-200: "oklch(86.9% 0.07 293.5)"
+ iris-300: "oklch(77.32% 0.129 294.81)"
+ iris-500: "oklch(59.6% 0.22 292)"
+ iris-700: "oklch(45.5% 0.2 291)"
+ aqua-100: "oklch(95.5% 0.03 215)"
+ aqua-200: "oklch(91% 0.06 215)"
+ aqua-400: "oklch(77.5% 0.13 222)"
+ aqua-700: "oklch(48% 0.105 226)"
+ ground-day: "oklch(97.65% 0.005 274.97)"
+ surface-day: "oklch(99.6% 0.002 280)"
+ raised-day: "oklch(95.2% 0.01 280)"
+ line-day: "oklch(90.5% 0.014 280)"
+ line-strong-day: "oklch(83% 0.02 280)"
+ ink-day: "oklch(24% 0.05 292)"
+ text-day: "oklch(37% 0.034 288)"
+ muted-day: "oklch(49% 0.026 286)"
+ on-ink-day: "oklch(98.5% 0.006 290)"
+ accent-soft-night: "oklch(26% 0.05 225)"
+ ground-night: "oklch(13.85% 0.025 273.24)"
+ surface-night: "oklch(17.4% 0.025 277)"
+ raised-night: "oklch(21.57% 0.029 280.68)"
+ line-night: "oklch(25.5% 0.035 272)"
+ line-strong-night: "oklch(33% 0.045 274)"
+ ink-night: "oklch(97.65% 0.005 274.97)"
+ text-night: "oklch(83% 0.016 266)"
+ muted-night: "oklch(71% 0.02 264)"
+ on-ink-night: "oklch(16% 0.03 270)"
+ media-ground-day: "oklch(19% 0.03 280)"
+ media-ground-night: "oklch(9% 0.02 273)"
+ on-media-chip: "oklch(98% 0.005 285)"
+ on-media-ink: "oklch(20% 0.04 285)"
+ media-glass: "oklch(15% 0.02 280 / 0.72)"
+typography:
+ display:
+ fontFamily: "Archivo, Familjen Grotesk, ui-sans-serif, sans-serif"
+ fontSize: "clamp(2rem, 1.2rem + 3vw, 4rem)"
+ fontWeight: 800
+ lineHeight: 0.95
+ letterSpacing: "-0.01em"
+ fontVariation: "'wdth' 72"
+ page-title:
+ fontFamily: "Archivo, Familjen Grotesk, ui-sans-serif, sans-serif"
+ fontSize: "clamp(2.25rem, 1.4rem + 3vw, 4rem)"
+ fontWeight: 800
+ lineHeight: 0.95
+ letterSpacing: "-0.01em"
+ fontVariation: "'wdth' 72"
+ rail-title:
+ fontFamily: "Archivo, Familjen Grotesk, ui-sans-serif, sans-serif"
+ fontSize: "2.6rem"
+ fontWeight: 900
+ lineHeight: 0.86
+ letterSpacing: "-0.005em"
+ fontVariation: "'wdth' 62"
+ headline:
+ fontFamily: "Archivo, Familjen Grotesk, ui-sans-serif, sans-serif"
+ fontSize: "clamp(1.35rem, 1.1rem + 0.8vw, 1.75rem)"
+ fontWeight: 800
+ lineHeight: 1.15
+ letterSpacing: "-0.01em"
+ fontVariation: "'wdth' 72"
+ row-title:
+ fontFamily: "Archivo, Familjen Grotesk, ui-sans-serif, sans-serif"
+ fontSize: "clamp(1.1rem, 0.9rem + 0.8vw, 1.6rem)"
+ fontWeight: 800
+ lineHeight: 1.02
+ fontVariation: "'wdth' 72"
+ body:
+ fontFamily: "Familjen Grotesk, ui-sans-serif, system-ui, sans-serif"
+ fontSize: "1rem"
+ fontWeight: 400
+ lineHeight: 1.55
+ fontFeature: "'tnum'"
+ lede:
+ fontFamily: "Familjen Grotesk, ui-sans-serif, system-ui, sans-serif"
+ fontSize: "1.125rem"
+ fontWeight: 400
+ lineHeight: 1.625
+ body-prose:
+ fontFamily: "Familjen Grotesk, ui-sans-serif, system-ui, sans-serif"
+ fontSize: "1.0625rem"
+ fontWeight: 400
+ lineHeight: 1.7
+ label:
+ fontFamily: "Familjen Grotesk, ui-sans-serif, system-ui, sans-serif"
+ fontSize: "0.75rem"
+ fontWeight: 650
+ letterSpacing: "0.04em"
+ script-live-voice-0:
+ fontFamily: "Archivo, Familjen Grotesk, ui-sans-serif, sans-serif"
+ fontSize: "clamp(2.25rem, 1.2rem + 2.8vw, 3.5rem)"
+ fontWeight: 900
+ lineHeight: 0.98
+ fontVariation: "'wdth' 68"
+ script-live-voice-1:
+ fontFamily: "Young Serif, ui-serif, Georgia, serif"
+ fontSize: "clamp(2.25rem, 1.2rem + 2.8vw, 3.5rem)"
+ fontWeight: 400
+ lineHeight: 1.12
+ script-live-caption:
+ fontFamily: "Familjen Grotesk, ui-sans-serif, system-ui, sans-serif"
+ fontSize: "clamp(2.25rem, 1.2rem + 2.8vw, 3.5rem)"
+ fontWeight: 700
+ lineHeight: 1.02
+ letterSpacing: "-0.02em"
+ script-rest:
+ fontFamily: "Familjen Grotesk, ui-sans-serif, system-ui, sans-serif"
+ fontSize: "1rem"
+ lineHeight: 1.12
+rounded:
+ container: "3px"
+ container-lg: "4px"
+ chip: "6px"
+ thumb: "8px"
+ field: "12px"
+ float: "12px"
+ portrait: "16px"
+ sheet: "22px"
+ pill: "999px"
+spacing:
+ gutter: "clamp(16px, 3.2vw, 48px)"
+ rail: "272px"
+ topbar: "60px"
+ tabbar: "62px"
+ dock: "68px"
+ dock-desktop: "84px"
+ row-gap: "20px"
+components:
+ button-primary:
+ backgroundColor: "{colors.ink-day}"
+ textColor: "{colors.on-ink-day}"
+ rounded: "{rounded.pill}"
+ padding: "0.75rem 1.25rem"
+ button-primary-hover:
+ backgroundColor: "{colors.iris-500}"
+ textColor: "{colors.ink-day}"
+ button-secondary:
+ backgroundColor: "{colors.surface-day}"
+ textColor: "{colors.ink-day}"
+ rounded: "{rounded.pill}"
+ padding: "0.75rem 1.25rem"
+ platform-pill:
+ textColor: "{colors.ink-day}"
+ rounded: "{rounded.pill}"
+ padding: "0.625rem 1.25rem 0.625rem 1rem"
+ icon-button:
+ textColor: "{colors.text-day}"
+ rounded: "{rounded.pill}"
+ size: "40px"
+ dock-play:
+ backgroundColor: "{colors.ink-day}"
+ textColor: "{colors.on-ink-day}"
+ rounded: "{rounded.pill}"
+ size: "44px"
+ stage-play:
+ backgroundColor: "{colors.on-media-chip}"
+ textColor: "{colors.on-media-ink}"
+ rounded: "{rounded.pill}"
+ size: "clamp(56px, 6vw, 76px)"
+ row-play:
+ backgroundColor: "{colors.surface-day}"
+ textColor: "{colors.ink-day}"
+ rounded: "{rounded.pill}"
+ size: "44px"
+ row-play-current:
+ backgroundColor: "{colors.ink-day}"
+ textColor: "{colors.on-ink-day}"
+ medium-switch:
+ backgroundColor: "{colors.ground-day}"
+ textColor: "{colors.muted-day}"
+ rounded: "{rounded.pill}"
+ padding: "3px"
+ medium-switch-selected:
+ backgroundColor: "{colors.ink-day}"
+ textColor: "{colors.on-ink-day}"
+ rounded: "{rounded.pill}"
+ padding: "0.45rem 0.9rem"
+ nav-item:
+ textColor: "{colors.text-day}"
+ rounded: "{rounded.container}"
+ padding: "0.55rem 0.7rem"
+ nav-item-current:
+ backgroundColor: "{colors.iris-100}"
+ textColor: "{colors.iris-700}"
+ seek-chip:
+ backgroundColor: "{colors.iris-100}"
+ textColor: "{colors.iris-700}"
+ rounded: "{rounded.chip}"
+ padding: "1px 0.375rem"
+ input:
+ backgroundColor: "{colors.surface-day}"
+ textColor: "{colors.ink-day}"
+ rounded: "{rounded.field}"
+ padding: "0.75rem 1rem"
+---
+
+# Design System: Starpod
+
+## Overview
+
+**Creative North Star: "The Typeset Conversation"**
+
+A podcast is people talking, so Starpod typesets the conversation. The episode stage puts the video (or the show's artwork) beside a live script in which each voice has its own face, the line being heard swells to display size, and spoken lines shrink and soften back into the page. Everything else (the list of episodes, the shell, the pages) speaks in the same condensed, uppercase display voice and a calm grotesque for UI.
+
+One engine runs the whole visit. A single persistent `` element plays the episode's HLS video or MP3, moves physically between the episode stage and the dock, and writes playback state onto `` and a live `--playback-progress` number so CSS can react without islands. Light and dark are both first-class: day uses Iris, night uses Aqua. The styles are still scoped under ``, which is hardcoded; there is one world.
+
+The system is generic by construction. Show artwork and cast photos supply the only imagery colour, shown in full colour, and every surface has to look deliberate for any show's art.
+
+**Key Characteristics:**
+- One OKLCH palette, one shell, one Stage world.
+- Light is computed, not painted: the scrubber, the dock edge, and the stage light all take their position or colour from real playback.
+- Iris by day, Aqua by night. The accent marks interaction, current state, and playback, nothing else.
+- Three hover behaviours, never mixed: a gradient ring on outlined controls, a gradient fill on solid ones, a gradient icon on bare icons.
+- Condensed uppercase Archivo for every title; Familjen Grotesk for everything you read or operate.
+- Fixed navigation keeps play, follow, and navigation on screen at every size.
+
+## Colors
+
+Cool violet-grey neutrals carrying two rationed accents: Iris (violet) owns the light scheme and Aqua (cyan) owns the dark one. Tailwind exposes the live tokens as utilities (`text-ink`, `bg-surface`, `border-line`, `ring-accent-soft`, `from-glow-a` …) through `@theme inline`, so one class follows both schemes.
+
+### Primary
+- **Iris** (iris-500): the light-scheme accent. Focus rings, selection, caret, the buffering arc, and the bright end of the day gradient.
+- **Deep Iris** (iris-700): light-scheme accent ink, for text in the accent: current nav items, seek chips, the "Video" kind marker, prose links. It is also voice 0's colour by day.
+- **Iris Wash** (iris-100): the light-scheme soft accent fill behind current nav items and seek chips, and the focus ring around fields.
+- **Pale Iris** (iris-200): the soft end of the day gradient. **Lilac** (iris-300) is voice 0 by night.
+
+### Secondary
+- **Aqua** (aqua-400): the dark-scheme accent, playing every role Iris plays by day.
+- **Pale Aqua** (aqua-200): dark-scheme accent ink, the bright end of the night gradient, and voice 1 by night.
+- **Deep Aqua** (aqua-700): voice 1's colour by day.
+- **Night Accent Wash** (accent-soft-night): the dark-scheme soft accent fill.
+
+### Neutral
+- **Ground / Surface / Raised** (day and night): page ground, then the shell panels, cards, and fields, then hover fills and keyboard hints. All are faintly violet-tinted so neither scheme reads as dead grey.
+- **Line / Line Strong**: hairline dividers and every default border (a bare `border` resolves to Line). Line Strong is for secondary-button and switch borders and the breadcrumb chevron.
+- **Ink / Text / Muted**: headings and primary controls, then body, then metadata and secondary labels. **On Ink** is the text on ink-filled controls and flips with the scheme. **On Glow** is the text on the gradient fill (ink by day, on-ink by night).
+- **Media Ground** (media-ground-day / -night): the near-black field behind video and artwork in the stage frame and mini player. **On-Media Chip / Ink** form the fixed light play disc over media, and **Media Glass** is the translucent dark "Resume at" chip beside it; all three ignore the scheme.
+
+### Named Rules
+**The Two Lamps Rule.** Iris is the only accent by day and Aqua the only accent by night. Accent fills are limited to interaction, the current item, and playback, and never decorate resting content.
+
+**The Computed Light Rule.** Every moving gradient or glow takes its position from `--playback-progress`, from sampled video, or from a hover/focus state. A gradient that no state drives does not belong in the system.
+
+**The OKLCH Only Rule.** Every colour is authored in OKLCH, including shadows, masks, and backdrops. Hex and rgb are never used.
+
+**The One Palette Rule.** Tailwind's theme holds only the token colours above. There are no parallel light/dark colour pairs; a single token class follows both schemes.
+
+## Typography
+
+**Display Font:** Archivo variable, with weight and width axes (falls back to Familjen Grotesk)
+**UI / Body Font:** Familjen Grotesk (with ui-sans-serif, system-ui)
+**Voice 1:** Young Serif (with ui-serif, Georgia)
+
+**Character:** Archivo, condensed to 72% width and set uppercase at 800, is the loud stage voice for every title. Familjen Grotesk is the calm voice for reading and operating. Young Serif answers Archivo as the second speaker in the script. All numerals are tabular.
+
+### Hierarchy
+- **Display** (800, 72% width, uppercase, `display`): the episode title on the stage, max 18ch.
+- **Page title** (800, 72% width, uppercase, `page-title`): the `PageHeader` on About, Contact, and other standalone pages, max 18ch, balanced. The 404 heading uses the same face one step smaller.
+- **Rail title** (900, 62% width, `rail-title`): the show name in the desktop rail.
+- **Headline** (800, 72% width, uppercase, `headline`): section titles ("Show notes", "Listen on", "Meet the hosts").
+- **Row title** (800, 72% width, uppercase, `row-title`): episode titles in the list; the current episode's title takes the voice-0 colour.
+- **Lede** (1.125rem/1.625, max 62ch, Text): the paragraph under a page title.
+- **Body** (400, 1rem/1.55): UI text. Stage descriptions are 1.0625rem, max 62ch. Show notes and transcripts use `body-prose` via Tailwind `prose` (max ~70–76ch).
+- **Label** (650, 0.75rem, 0.04em tracking): rail group labels ("Hosted by", "Follow the show"), "Presented by", Host/Guest tags (uppercase), and field labels at 0.875rem 600.
+- **Script**: the live line (`data-d="0"`) sets at `script-live-*` in its voice's face. One and two lines back step down to 1.4rem and 1.15rem; three to five back drop to 0.9rem with a 0.4px blur; upcoming lines sit at 0.95rem. Long live lines cap at clamp(1.75rem, 1rem + 1.9vw, 2.75rem).
+
+### Named Rules
+**The One Face Per Voice Rule.** In the script and the cast, voice 0 is condensed Archivo in the voice-0 colour, voice 1 is Young Serif in the voice-1 colour and right-aligned, and further voices or unattributed captions are Familjen in ink. A voice face always identifies a speaker.
+
+**The Volume Rule.** Size, width, and opacity carry distance from the live line. They are set by the engine's `data-d` attribute and never by hand.
+
+**The Upright Time Rule.** Every timestamp is upright, tabular, and in `HH:MM:SS` on seek chips.
+
+## Layout
+
+Layout is an app shell with a single main column.
+
+- **Desktop (≥1024px):** a sticky full-height rail (272px) holds the show art (with a tilt on hover), show name, blurb, search, navigation, follow links, and hosts. The dock spans the remaining width at the bottom (84px). The main column pads by the dock height plus 64px and caps at 1280px on pages.
+- **Below 1024px:** a sticky blurred top bar (60px plus safe area) carries the show and an ink "Follow" pill. A fixed three-up tab bar (Episodes, Search, More; 62px plus safe area) sits at the bottom with the dock (68px) above it. Sheets rise from the bottom as native popovers, max 560px wide.
+- **Gutter:** clamp(16px, 3.2vw, 48px). Breadcrumbs, page titles, and content share one left edge.
+- **Home:** the episode list is the page: hairline-ruled rows with art, facts, title, two-line description, and a play disc.
+- **Episode stage (desktop):** the frame and meta sit on the left beside a sticky script column at 0.95fr. With no transcript the stage collapses to one column, max 1100px. On phones the script performs directly under the picture (max 34vh), then the meta.
+- **Standalone pages:** `PageHeader`, then sections separated by 4–5rem. About lays hosts out in two columns from 1024px. Contact keeps the form to 36rem with name and email side by side from 640px.
+- **Mini player:** when a watched episode's stage scrolls away, the video floats bottom-right at clamp(260px, 24vw, 400px) on desktop or min(52vw, 360px) on phones. It is fixed above the page and never changes the page's layout.
+- **Foldables** (two viewport segments, or a coarse-pointer tablet aspect): the stage becomes two pages either side of a hinge gap of at least 40px; voice 0 takes the left page and voice 1 the right.
+- **Breakpoints:** 640px, 768px, 1024px, 1100px.
+
+**The Never-Hidden CTA Rule.** Play, follow, and navigation are fixed chrome at every size: the rail on desktop, the top bar plus tab bar plus dock below that. Page content pads for every fixed layer it could sit under.
+
+## Elevation & Depth
+
+Depth comes mainly from tone (Ground → Surface → Raised) and from light sampled out of the media. Shadows are reserved for objects that float above the page.
+
+### Shadow Vocabulary
+- **Soft** (`--shadow-soft`, two-layer violet-tinted by day, black by night): the stage frame, show art, and mini-player chrome.
+- **Float** (`--shadow-float`): things lifted off the page, such as the artwork in the stage frame, the stage play disc, bottom sheets, and the floating mini video.
+- **Dock lip** (a single upward shadow, `0 -12px 32px -24px`): separates the dock from content scrolling under it.
+
+### Named Rules
+**The Stage Light Rule.** The glow behind the stage frame is sampled from the playing video into a 32×18 canvas (artwork glow when nothing plays). It is the only ambient colour on the page and it is always computed.
+
+**The Two Shadows Rule.** Soft and Float are the only elevation shadows. A hover is shown by the ring, the gradient fill, or a Raised fill, never by a deeper shadow or a lift.
+
+## Shapes
+
+Interactive controls are pills or circles (999px): buttons, play discs, the medium switch, platform pills, search, and the Follow pill. Containers are near-square (3px, or 4px for large surfaces like the frame). Fields are softer (12px), host portraits on About are 16px, show art and the mini player 12px, row and dock art 8px, seek chips 6px, sheets 22px at the top. Cast photos on the stage take the container radius. Iconography is one 24px, 1.75-stroke outline set (`icons.tsx`), with filled play and pause glyphs and skip icons that print their seconds inside.
+
+**The Pill Controls Rule.** If it can be pressed, it is round. Corner radius on containers is near-square; corner radius on controls is full.
+
+**The Shape-Keeping Focus Rule.** Focus never changes an element's shape. The global ring is a 2px accent outline at 3px offset that follows the element's own radius; fields replace it with an accent border and a 4px Accent Wash ring.
+
+## Components
+
+### Buttons
+- **Shape:** full pill (999px), 0.75rem × 1.25rem padding, 0.9375rem at 700.
+- **Primary (solid):** ink fill with On Ink text ("Play episode", "Send message"). Hover and focus fade the fill into the Glow A→B gradient over 300ms (registered `--fill-a/--fill-b`) and the text to On Glow. Press scales to 0.97 on the spring.
+- **Secondary (outlined):** surface fill, 1px Line Strong border, ink text ("Read the full transcript", "Go back"). Hover and focus draw the ring.
+- **Icon button:** a 40px circle with no fill at rest. Hover turns the icon itself into the gradient (each SVG carries its own `linearGradient`, stops transition 300ms).
+- **Text button:** a 34px pill with a Line border, used for the playback rate; wears the ring.
+
+### Play discs
+- **Stage play:** clamp(56px, 6vw, 76px) circle with the fixed light On-Media disc and Float shadow, bottom-left on the frame. It fades out while a video plays and returns on frame hover or focus. A Media Glass "Resume at" chip sits beside it.
+- **Dock play:** 44px ink circle; hover fills with the gradient. Press scales it to 0.92.
+- **Row play:** 44px surface circle with a Line Strong border and the ring on hover. On the current episode it turns into a solid ink disc with three on-air bars that pulse while playing and give way to the glyph on hover.
+- **Buffering:** a 2px accent arc spins around the disc (`.play-toggle[data-buffering]::before`, 900ms linear).
+- **Glyph:** play and pause spring between each other.
+
+### Medium switch (Watch / Listen)
+A pill track on Ground with a Line Strong border and 3px inset. An ink thumb slides under the chosen option on the spring (520ms) and the chosen label turns On Ink. Wears the ring. A compact size is used in the dock.
+
+### Inputs
+- **Style:** 1px Line border, Surface fill, 12px radius, 0.75rem × 1rem padding, with a visible label above (0.875rem 600 ink). Placeholders are Muted and only add an example.
+- **Focus:** the border turns Accent and a 4px Accent Wash ring appears (200ms); the outline is removed so the field keeps its radius.
+- **States:** the submit button disables and reads "Sending…"; errors appear as a bordered note above the button with `role="alert"`; success replaces the form with a Surface panel.
+- **Search dialog:** a Surface panel with a Line border; the field has no ring of its own, and the hairline under it turns Accent while focused.
+
+### Navigation
+Rail and sheet links are 600 weight with a 24px muted icon and container radius. Hover gives a Raised fill and ink text. The current page gets the Accent Wash fill and accent-ink text and icon. Config `links` choose an icon (`external`, `heart`, `link`, `sponsor`, `store`; default `external` for URLs, `link` for local pages). The tab bar is three even cells with a 0.6875rem label; the current cell is accent ink.
+
+### Breadcrumbs
+0.8125rem Muted links with a Line Strong chevron, an even 8px either side; the current crumb is Text at 500. Hover turns a crumb Ink. Hidden on the episode stage.
+
+### Episode rows
+Hairline-ruled rows: full-colour art (56/72px, 8px radius), facts in Muted 0.8125rem with the number in ink and a "Video" kind marker in accent ink, the condensed uppercase title, a two-line description from 768px up, and a row play disc. The whole row is the link. Clicking a row morphs its art into the stage frame's artwork and its title into the stage title (480ms).
+
+### Platform pills
+Labelled pills (About, the follow sheet): 1px Line border, an 18px platform glyph in Muted, ink label, the ring on hover. In the rail they are 40px icon-only circles on Ground.
+
+### Seek chips
+Timestamps in show notes and transcripts are 6px-radius chips in Accent Wash with accent-ink 600 tabular `HH:MM:SS`. Hover and focus fill them with the gradient. Brackets around a chapter time are absorbed into the chip. Clicking seeks the player.
+
+### Cast and sponsors
+The stage lists the episode's hosts (configured order, then guest hosts) and guests (alphabetical) with full-colour 52px photos, names in their voice's face when they speak as voice 0 or 1, and a "Host"/"Guest" label. "Presented by" lists the episode's sponsors with inline logos (filled in ink) and hides when empty.
+
+### Dock and mini player
+The dock is a fixed transport bar on Surface that slides in once per visit (600ms). On phones, progress is a 2px gradient light along its top edge. On desktop it has a full scrubber: a 4px track filled with the gradient to the playhead, a 14px ink thumb that grows to 1.25× on hover, tabular times, and a transcript preview of the line at the hovered time. The mini video sits on Media Ground with Float shadow under a Surface chrome strip (title, fullscreen, close). Clicking the video opens its episode. Close pauses playback and hides the video; any play brings it back. Keyboard: K/space play, J/L skip, M mute, W watch/listen, F fullscreen.
+
+### Signature: the ring
+A 1px gradient ring (Glow A to Glow B, to bottom right) that follows the element's own radius. On hover (pointer devices only) or keyboard focus it sweeps itself on over 500ms along `--ease-halo`, an animated `@property --halo` with `inherits: true`. It belongs only on outlined controls sitting on the page background.
+
+**The Three Hovers Rule.** Outlined controls draw the ring; solid controls fill with the gradient; bare icons turn the icon to the gradient. A control gets exactly one, and every one transitions.
+
+### Signature: the live script
+The script column bottom-aligns its lines under a top fade mask and performs the conversation by distance. When the live line changes, each line FLIPs from its old box to its new one with transforms only (720ms, `cubic-bezier(0.25, 1, 0.5, 1)`), arrivals rise from below, and a jump of more than three lines crossfades instead. Hovering or focusing a line reveals its speaker and time; clicking seeks. It follows seeks and skips immediately.
+
+### Signature: page transitions
+Navigations play a curtain: the old page drops away (240ms) and the new one rises in (640ms ease-out, slight blur), reversed on back. The rail, top bar, and tab bar cross-fade in 180ms, unpaired elements fade solo, and the dock never animates.
+
+### Signature, foldables: the unfold
+On first detecting the spread, each page swings open once from the hinge (rotateY 62deg to 0, 1000ms expo-out), keyed by a one-shot `data-unfolding` attribute.
+
+## Do's and Don'ts
+
+### Do:
+- **Do** read state from the engine: style `[data-current]`, `[data-playing]`, `[data-watching]`, `[data-buffering]`, `html[data-medium]`, `html[data-host]`, and `--playback-progress` instead of adding new JS-driven classes.
+- **Do** style new work with Tailwind utilities on the token colours; keep custom CSS for what Tailwind cannot express (`@property` animations, the ring, view transitions, voice typography).
+- **Do** choose the hover by the control's shape: ring for outlined, gradient fill for solid, gradient icon for bare icons, always with a transition.
+- **Do** use the easings: expo-out (`cubic-bezier(0.16, 1, 0.3, 1)`) for state and reveal, the `--ease-halo` curve for the ring, and the overshooting `linear()` spring for press, thumb, and glyph motion. Everything collapses to 1ms under `prefers-reduced-motion`.
+- **Do** open standalone pages with `PageHeader` and align them to the breadcrumbs.
+- **Do** give fields visible labels and the accent border plus Accent Wash ring on focus.
+
+### Don't:
+- **Don't** author colour in hex, rgb, or hsl anywhere, including docs, shadows, and masks.
+- **Don't** reintroduce parallel light/dark Tailwind colours (`bg-light-*`, `dark:bg-dark-*`). Use the single token class.
+- **Don't** let an accent fill decorate resting content.
+- **Don't** reshape an element on focus or put a ring on a control that already fills or has no outline.
+- **Don't** add a third elevation shadow or a hover lift.
+- **Don't** desaturate or duotone show art or cast photos; show imagery in full colour.
+- **Don't** use a voice face (Archivo condensed as a speaker, Young Serif) for anything other than a speaker or their name; Archivo as a title face is fine.
+- **Don't** hide play, follow, or navigation behind scroll.
+- **Don't** add show-specific copy, colour, or imagery to the package. Show artwork and the site's own data are the only imagery and content sources.
diff --git a/packages/starpod/PRODUCT.md b/packages/starpod/PRODUCT.md
new file mode 100644
index 0000000..41d779f
--- /dev/null
+++ b/packages/starpod/PRODUCT.md
@@ -0,0 +1,97 @@
+# Product
+
+
+
+## Platform
+
+web
+
+## Users
+
+Two audiences, served by one package:
+
+- **Listeners and viewers** of a show built on Starpod. They arrive from a
+ shared episode link, a search result, or the show's own promotion, and want
+ to start the episode immediately (watch or listen), then subscribe on their
+ platform of choice, browse other episodes, read a transcript, or contact the
+ show.
+- **Podcasters** (the package's consumers) who install `starpod`, point it at
+ an RSS feed, fill in `starpod.config.ts`, and get a finished site. Their job
+ is "have a great-looking show site without designing or maintaining one."
+
+## Product Purpose
+
+Starpod generates a complete podcast website from an RSS feed and a small
+config file, as an Astro integration. Success: a podcaster ships a site that
+feels hand-crafted rather than templated, with zero design work, and visitors
+reach play, subscribe, and other CTAs without hunting.
+
+## Positioning
+
+The whole site comes from the feed: episodes, artwork, transcripts
+(``), and video (`` HLS
+streams) all flow from RSS at build time. Updating the site is a dependency
+update. It is free and open source.
+
+## Operating Context
+
+- The site is built statically by Astro and deployed (reference: Vercel).
+- Content comes from RSS at build time; guests and sponsors optionally come
+ from a Turso/Drizzle database (`database` option).
+- Consumers customize with `customCss`, Starlight-style component overrides
+ (`virtual:starpod/components/*`), config `links`, and custom pages composed
+ from the package `Layout`.
+- The player persists across client-side navigations (Astro `ClientRouter`,
+ `transition:persist`).
+
+## Capabilities and Constraints
+
+- **Video-first, automatically:** when an episode's feed item has a video
+ `alternateEnclosure` (HLS), that episode leads with video and the visitor can
+ switch to audio at will. Episodes without video lead with artwork plus audio.
+ Podcasters configure nothing for this.
+- **Playback persists across pages:** video docks to a mini video player when
+ the visitor navigates away, with controls to expand or switch to audio.
+- Must keep: RSS-driven episodes and show info, search, transcripts with
+ clickable timestamps (RSS and markdown), the persistent player, platform
+ subscribe links, hosts, creators and guests, sponsors, the contact form,
+ `.html.md` / `llms.txt` / OpenAPI agent endpoints, markdown content
+ negotiation, standard.site and ATProto tags, and the override and customCss
+ hooks.
+- Must stay generic: no show-specific copy or imagery in the package. Any show
+ should look intentional from its artwork and config alone.
+- All colors are authored in OKLCH.
+
+## Brand Commitments
+
+- The visual world is Stage, chosen in the 2026-11 redesign and recorded in
+ DESIGN.md. It replaced the old layout and type, kept the Iris/Aqua accents,
+ and kept every piece of content and every feature.
+- The reference deployment is whiskey.fm (Whiskey Web and Whatnot). It
+ demonstrates the package and does not define it.
+
+## Evidence on Hand
+
+- The live reference feed (Flightcast) has 261 episodes. 71 of them carry HLS
+ video streams, and nearly all carry JSON transcripts.
+- Show artwork, episode artwork, host photos (`src/img/people/`), and sponsor
+ logos live in the reference site.
+- No testimonials, usage numbers, or press exist. Do not invent them.
+
+## Product Principles
+
+1. The episode is the hero: play, in the visitor's chosen medium, is never more
+ than one glance away.
+2. Every CTA is visible without digging: subscribe, links, and contact are not
+ buried at the bottom of a scrolling sidebar.
+3. Zero-config delight: craft and motion come for free from the feed and are
+ never a setup step for the podcaster.
+4. The visitor decides between watching and listening, and the site remembers
+ that choice.
+5. Generic by construction: every surface must look deliberate for any show's
+ artwork and palette.
+
+## Accessibility & Inclusion
+
+Motion respects `prefers-reduced-motion`. Player controls are keyboard and
+screen-reader operable. Light and dark color schemes are both first-class.