From 88557198f135a6f8b1f0f208ee83a2223619bfcf Mon Sep 17 00:00:00 2001 From: Robert Wagner Date: Fri, 13 Nov 2026 21:16:26 -0500 Subject: [PATCH 1/3] Video-first Stage redesign Rebuild the site around a single persistent video/audio engine with a Watch/Listen switch, and the Stage episode page: live transcript, cast and sponsors from the database, scrubber transcript previews, keyboard shortcuts, stage light, and list-to-episode morphs. - Home is the episode list; the dock carries playback across pages. - About, Contact, and 404 restyled with a shared PageHeader. - Tailwind palette reduced to the new tokens; old light/dark colors, gradient-icon utility, Inter font, Dots, and the old player removed. - Breadcrumbs rebuilt; focus styles no longer reshape elements. - Nav links accept an optional icon. Co-Authored-By: Claude Opus 5.5 --- CLAUDE.md | 21 +- packages/starpod/README.md | 19 +- packages/starpod/package.json | 1 + packages/starpod/src/assets/avatar-dark.png | Bin 4359 -> 4532 bytes packages/starpod/src/assets/avatar-light.png | Bin 4001 -> 4174 bytes packages/starpod/src/assets/dots-dark.svg | 1117 --------------- packages/starpod/src/assets/dots-light.svg | 1116 --------------- packages/starpod/src/assets/forward-icon.svg | 25 - packages/starpod/src/assets/mute-icon.svg | 26 - packages/starpod/src/assets/rewind-icon.svg | 25 - packages/starpod/src/assets/rocket-dark.svg | 3 - packages/starpod/src/assets/rocket-light.svg | 3 - packages/starpod/src/assets/unmute-icon.svg | 24 - .../src/components/AdPackageCard.astro | 14 +- .../starpod/src/components/Breadcrumbs.astro | 60 +- .../starpod/src/components/ContactForm.tsx | 127 +- packages/starpod/src/components/Dots.astro | 3 - .../starpod/src/components/EpisodeList.astro | 161 ++- .../starpod/src/components/EpisodeStage.astro | 150 ++ .../starpod/src/components/FullPlayButton.tsx | 99 +- packages/starpod/src/components/Hosts.astro | 16 +- .../starpod/src/components/InfoCard.astro | 59 +- .../src/components/LargePlatforms.astro | 115 +- .../src/components/NotFoundContent.astro | 69 +- .../starpod/src/components/PageHeader.astro | 26 + .../starpod/src/components/Platforms.astro | 96 +- packages/starpod/src/components/Player.tsx | 157 --- .../starpod/src/components/SearchButton.tsx | 34 +- .../starpod/src/components/SearchDialog.tsx | 34 +- .../starpod/src/components/ShowArtwork.astro | 46 +- .../episode/CreatorsAndGuests.astro | 91 -- .../components/episode/MarkdownTranscript.tsx | 2 +- .../src/components/episode/SeekChip.tsx | 13 + .../src/components/episode/ShowNotes.tsx | 89 ++ .../src/components/episode/Sponsors.astro | 46 +- .../src/components/episode/Transcript.tsx | 26 +- packages/starpod/src/components/icons.tsx | 193 +++ .../starpod/src/components/media/Dock.tsx | 190 +++ .../src/components/media/LiveScript.tsx | 170 +++ .../src/components/media/MediumSwitch.tsx | 46 + .../src/components/media/PlayGlyph.tsx | 55 + .../src/components/media/PlayToggle.tsx | 57 + .../starpod/src/components/media/Scrubber.tsx | 128 ++ .../src/components/media/StageControls.tsx | 111 ++ .../starpod/src/components/media/cue-cache.ts | 36 + .../starpod/src/components/media/engine.ts | 442 ++++++ .../starpod/src/components/media/shortcuts.ts | 89 ++ .../src/components/media/stage-light.ts | 88 ++ .../components/player/ForwardButton/index.tsx | 23 - .../player/ForwardButton/styles.css | 3 - .../components/player/MuteButton/index.tsx | 15 - .../components/player/MuteButton/styles.css | 7 - .../src/components/player/PlayButton.tsx | 70 - .../components/player/PlaybackRateButton.tsx | 38 - .../components/player/RewindButton/index.tsx | 23 - .../components/player/RewindButton/styles.css | 3 - .../src/components/player/Slider/index.tsx | 64 - .../src/components/player/Slider/styles.css | 125 -- packages/starpod/src/components/state.ts | 76 +- packages/starpod/src/index.ts | 38 +- packages/starpod/src/layouts/Layout.astro | 186 ++- packages/starpod/src/lib/cast.ts | 85 ++ packages/starpod/src/lib/cues.ts | 211 +++ packages/starpod/src/lib/episode-cues.ts | 28 + packages/starpod/src/lib/feed-media.ts | 86 ++ .../src/lib/rehype-transcript-timestamps.mjs | 39 +- packages/starpod/src/lib/rss.ts | 14 +- packages/starpod/src/lib/seek-chip.d.mts | 10 + packages/starpod/src/lib/seek-chip.mjs | 48 + packages/starpod/src/lib/transcript.ts | 4 +- packages/starpod/src/pages/[episode].astro | 211 ++- packages/starpod/src/pages/about.astro | 120 +- .../src/pages/api/cues/[episode].json.ts | 23 + packages/starpod/src/pages/contact.astro | 19 +- packages/starpod/src/pages/for-llms.astro | 28 +- packages/starpod/src/pages/index.astro | 10 +- packages/starpod/src/styles/buttons.css | 43 - packages/starpod/src/styles/global.css | 97 +- packages/starpod/src/styles/gradient-icon.css | 45 - packages/starpod/src/styles/interactions.css | 238 ++++ packages/starpod/src/styles/shell.css | 1246 +++++++++++++++++ packages/starpod/src/styles/stage.css | 447 ++++++ packages/starpod/src/styles/tailwind.css | 68 +- packages/starpod/src/styles/tokens.css | 235 ++++ packages/starpod/src/styles/worlds.css | 509 +++++++ packages/starpod/src/svgs/apple.svg | 2 +- packages/starpod/src/svgs/overcast.svg | 2 +- packages/starpod/src/svgs/pocket-casts.svg | 2 +- packages/starpod/src/svgs/spotify.svg | 2 +- packages/starpod/src/svgs/youtube.svg | 4 +- packages/starpod/src/utils/config.ts | 15 +- packages/starpod/src/utils/playable.ts | 31 + pnpm-lock.yaml | 8 + src/img/sponsors/cascadiajs.svg | 2 +- src/img/sponsors/code-rabbit.svg | 2 +- src/img/sponsors/gitkraken.svg | 2 +- src/img/sponsors/norlan.svg | 2 +- src/img/sponsors/warp.svg | 4 +- src/pages/sponsor.astro | 10 +- starpod.config.ts | 4 +- tests/e2e/episode.spec.ts | 40 +- tests/e2e/index.spec.ts | 2 +- tests/unit/Dock.test.tsx | 106 ++ tests/unit/ForwardButton.test.tsx | 92 -- tests/unit/FullPlayButton.test.tsx | 124 +- tests/unit/MuteButton.test.tsx | 80 -- tests/unit/PlayButton.test.tsx | 114 -- tests/unit/PlayToggle.test.tsx | 66 + tests/unit/PlaybackRateButton.test.tsx | 125 -- tests/unit/Player.test.tsx | 170 --- tests/unit/RewindButton.test.tsx | 92 -- tests/unit/SearchButton.test.tsx | 34 +- tests/unit/Slider.test.tsx | 146 -- tests/unit/cast.test.ts | 67 + tests/unit/config.test.ts | 16 + tests/unit/cues.test.ts | 55 + tests/unit/delight.test.tsx | 125 ++ tests/unit/feed-media.test.ts | 47 + .../unit/rehype-transcript-timestamps.test.ts | 27 +- tests/unit/seek-chip.test.tsx | 102 ++ tests/unit/stubs/astro-transitions-client.ts | 2 + vitest.config.ts | 4 + 122 files changed, 6809 insertions(+), 4972 deletions(-) delete mode 100644 packages/starpod/src/assets/dots-dark.svg delete mode 100644 packages/starpod/src/assets/dots-light.svg delete mode 100644 packages/starpod/src/assets/forward-icon.svg delete mode 100644 packages/starpod/src/assets/mute-icon.svg delete mode 100644 packages/starpod/src/assets/rewind-icon.svg delete mode 100644 packages/starpod/src/assets/rocket-dark.svg delete mode 100644 packages/starpod/src/assets/rocket-light.svg delete mode 100644 packages/starpod/src/assets/unmute-icon.svg delete mode 100644 packages/starpod/src/components/Dots.astro create mode 100644 packages/starpod/src/components/EpisodeStage.astro create mode 100644 packages/starpod/src/components/PageHeader.astro delete mode 100644 packages/starpod/src/components/Player.tsx delete mode 100644 packages/starpod/src/components/episode/CreatorsAndGuests.astro create mode 100644 packages/starpod/src/components/episode/SeekChip.tsx create mode 100644 packages/starpod/src/components/episode/ShowNotes.tsx create mode 100644 packages/starpod/src/components/icons.tsx create mode 100644 packages/starpod/src/components/media/Dock.tsx create mode 100644 packages/starpod/src/components/media/LiveScript.tsx create mode 100644 packages/starpod/src/components/media/MediumSwitch.tsx create mode 100644 packages/starpod/src/components/media/PlayGlyph.tsx create mode 100644 packages/starpod/src/components/media/PlayToggle.tsx create mode 100644 packages/starpod/src/components/media/Scrubber.tsx create mode 100644 packages/starpod/src/components/media/StageControls.tsx create mode 100644 packages/starpod/src/components/media/cue-cache.ts create mode 100644 packages/starpod/src/components/media/engine.ts create mode 100644 packages/starpod/src/components/media/shortcuts.ts create mode 100644 packages/starpod/src/components/media/stage-light.ts delete mode 100644 packages/starpod/src/components/player/ForwardButton/index.tsx delete mode 100644 packages/starpod/src/components/player/ForwardButton/styles.css delete mode 100644 packages/starpod/src/components/player/MuteButton/index.tsx delete mode 100644 packages/starpod/src/components/player/MuteButton/styles.css delete mode 100644 packages/starpod/src/components/player/PlayButton.tsx delete mode 100644 packages/starpod/src/components/player/PlaybackRateButton.tsx delete mode 100644 packages/starpod/src/components/player/RewindButton/index.tsx delete mode 100644 packages/starpod/src/components/player/RewindButton/styles.css delete mode 100644 packages/starpod/src/components/player/Slider/index.tsx delete mode 100644 packages/starpod/src/components/player/Slider/styles.css create mode 100644 packages/starpod/src/lib/cast.ts create mode 100644 packages/starpod/src/lib/cues.ts create mode 100644 packages/starpod/src/lib/episode-cues.ts create mode 100644 packages/starpod/src/lib/feed-media.ts create mode 100644 packages/starpod/src/lib/seek-chip.d.mts create mode 100644 packages/starpod/src/lib/seek-chip.mjs create mode 100644 packages/starpod/src/pages/api/cues/[episode].json.ts delete mode 100644 packages/starpod/src/styles/buttons.css delete mode 100644 packages/starpod/src/styles/gradient-icon.css create mode 100644 packages/starpod/src/styles/interactions.css create mode 100644 packages/starpod/src/styles/shell.css create mode 100644 packages/starpod/src/styles/stage.css create mode 100644 packages/starpod/src/styles/tokens.css create mode 100644 packages/starpod/src/styles/worlds.css create mode 100644 packages/starpod/src/utils/playable.ts create mode 100644 tests/unit/Dock.test.tsx delete mode 100644 tests/unit/ForwardButton.test.tsx delete mode 100644 tests/unit/MuteButton.test.tsx delete mode 100644 tests/unit/PlayButton.test.tsx create mode 100644 tests/unit/PlayToggle.test.tsx delete mode 100644 tests/unit/PlaybackRateButton.test.tsx delete mode 100644 tests/unit/Player.test.tsx delete mode 100644 tests/unit/RewindButton.test.tsx delete mode 100644 tests/unit/Slider.test.tsx create mode 100644 tests/unit/cast.test.ts create mode 100644 tests/unit/cues.test.ts create mode 100644 tests/unit/delight.test.tsx create mode 100644 tests/unit/feed-media.test.ts create mode 100644 tests/unit/seek-chip.test.tsx create mode 100644 tests/unit/stubs/astro-transitions-client.ts diff --git a/CLAUDE.md b/CLAUDE.md index 4ddd7fa5..4b5fb907 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -20,7 +20,7 @@ Whatnot podcast). - **Lint fix:** `pnpm lint:fix` - **All tests:** `pnpm test` (runs unit + e2e concurrently) - **Unit tests only:** `pnpm test:unit` (Vitest) -- **Single unit test:** `pnpm exec vitest run tests/unit/Player.test.tsx` +- **Single unit test:** `pnpm exec vitest run tests/unit/Dock.test.tsx` - **E2E tests only:** `pnpm test:e2e` (Playwright, auto-starts dev server) - **Seed remote DB:** `pnpm db:seed` - **Push schema to DB:** `pnpm db:push` @@ -64,9 +64,24 @@ connection is configured in `db/index.ts`. `Accept: text/markdown` clients, and the styled 404 page otherwise. API routes return structured JSON errors via `src/lib/api-errors.ts`. - `src/components/` — Mix of `.astro` (static) and `.tsx` (Preact interactive) - components. The audio player (`src/components/player/`) and search dialog are + components. The media player (`src/components/media/`) and search dialog are Preact. -- `src/components/state.ts` — Preact signals for shared player state. +- `src/components/state.ts` — Preact signals for shared player state + (current episode, Watch/Listen preference, playback readouts). +- `src/components/media/engine.ts` — one persistent `