From f04989907b3c6865eb3f34a934b39378d4027760 Mon Sep 17 00:00:00 2001 From: Adam Argyle Date: Mon, 16 Nov 2026 07:50:32 -0800 Subject: [PATCH] Redesign the site around the media Builds on the video-first Stage redesign (#71) and takes it across the whole site: a collapsible sidebar, an episode explorer on the home page, a player that stays with you between pages, and an episode page with a resizable stage. Shell - Collapsible sidebar that folds to an icon rail, with the hosts and the follow links in it. The fold is one PropFLIP flight over anchored auto layout, staggered with sibling-index(). - Search stays on Cmd/Ctrl+K and opens over anything, the player card included. Home - An episode explorer in place of the plain list: grid and list views, sort and filters, and a close-up with a filmstrip. Cards fly between views instead of cutting. Player - One media engine behind an island that is a dock, a pill, a corner picture or a full card with an Up next queue, and that survives client-side navigation. - The progress ship and its particles from the original player are on the island's scrubber. Episode page - A stage with Watch / Balanced / Read presets and a draggable divider, a sticky section bar, a live transcript, people cards and sponsors. Motion and state - motion/propflip.ts: FLIP flights with settle and viewport options. - prop-for-that publishes media state and pointer position as custom properties; pointer tracking is bound only while its element is hovered. - Scroll-state and anchor queries where supported, with plain fallbacks. Tests - Unit tests for the engine, queue, scrubber, flights and explorer query. - Playwright specs for the shell, explorer, player and episode page. Co-authored-by: Robert Wagner --- CLAUDE.md | 21 +- packages/starpod/.impeccable/config.json | 3 + packages/starpod/.impeccable/design.json | 820 +++++ .../surfaces/src-layouts-layout-astro.md | 71 + packages/starpod/DESIGN.md | 448 +++ packages/starpod/PRODUCT.md | 97 + packages/starpod/README.md | 51 +- packages/starpod/package.json | 4 +- 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 | 239 +- .../starpod/src/components/EpisodeStage.astro | 212 ++ .../starpod/src/components/FullPlayButton.tsx | 138 +- packages/starpod/src/components/Hosts.astro | 117 +- .../starpod/src/components/InfoCard.astro | 81 +- .../src/components/LargePlatforms.astro | 115 +- .../src/components/NotFoundContent.astro | 69 +- .../starpod/src/components/PageHeader.astro | 26 + .../starpod/src/components/PersonFace.astro | 32 + .../starpod/src/components/Platforms.astro | 113 +- packages/starpod/src/components/Player.tsx | 157 - .../starpod/src/components/SearchButton.tsx | 38 +- .../starpod/src/components/SearchDialog.tsx | 625 +++- .../starpod/src/components/ShowArtwork.astro | 53 +- .../src/components/episode/BarPlay.tsx | 42 + .../episode/CreatorsAndGuests.astro | 91 - .../src/components/episode/LiveTurn.tsx | 169 + .../components/episode/MarkdownTranscript.tsx | 23 +- .../src/components/episode/Onward.astro | 152 + .../src/components/episode/People.astro | 220 ++ .../src/components/episode/SectionBar.astro | 158 + .../src/components/episode/SeekChip.tsx | 13 + .../src/components/episode/ShowNotes.tsx | 91 + .../src/components/episode/SpeakerCard.tsx | 130 + .../src/components/episode/SponsorCards.astro | 53 + .../src/components/episode/Sponsors.astro | 46 +- .../src/components/episode/Tiles.astro | 35 + .../src/components/episode/Transcript.tsx | 93 +- .../starpod/src/components/episode/focus.ts | 17 + .../src/components/episode/speaking-source.ts | 134 + .../src/components/episode/speaking.ts | 10 + .../starpod/src/components/episode/split.ts | 362 +++ .../src/components/explorer/Card.astro | 148 + .../src/components/explorer/Hero.astro | 132 + .../src/components/explorer/Toolbar.astro | 246 ++ .../src/components/explorer/archive.ts | 211 ++ .../src/components/explorer/explorer.ts | 2167 +++++++++++++ .../starpod/src/components/explorer/icons.tsx | 36 + .../starpod/src/components/explorer/query.ts | 139 + packages/starpod/src/components/icons.tsx | 262 ++ .../illustrations/404Illustration.astro | 29 +- .../illustrations/UFOIllustration.astro | 28 +- .../starpod/src/components/media/Island.tsx | 838 +++++ .../src/components/media/LiveScript.tsx | 179 + .../src/components/media/MediumSwitch.tsx | 47 + .../src/components/media/PlayGlyph.tsx | 55 + .../src/components/media/PlayToggle.tsx | 91 + .../starpod/src/components/media/Scrubber.tsx | 146 + .../src/components/media/StageControls.tsx | 115 + .../starpod/src/components/media/board.ts | 670 ++++ .../starpod/src/components/media/cue-cache.ts | 36 + .../starpod/src/components/media/engine.ts | 750 +++++ packages/starpod/src/components/media/pip.ts | 123 + .../starpod/src/components/media/position.ts | 15 + .../starpod/src/components/media/publish.ts | 193 ++ .../starpod/src/components/media/shortcuts.ts | 89 + .../src/components/media/stage-light.ts | 88 + .../src/components/media/tone-worker.ts | 44 + .../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 | 228 +- packages/starpod/src/index.ts | 37 +- packages/starpod/src/layouts/Layout.astro | 1116 ++++++- packages/starpod/src/lib/cast.ts | 269 ++ packages/starpod/src/lib/cues.ts | 204 ++ packages/starpod/src/lib/episode-cues.ts | 28 + packages/starpod/src/lib/feed-media.ts | 86 + .../lib/rehype-transcript-timestamps.d.mts | 4 + .../src/lib/rehype-transcript-timestamps.mjs | 139 +- 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 | 62 +- packages/starpod/src/motion/propflip.css | 103 + packages/starpod/src/motion/propflip.ts | 428 +++ packages/starpod/src/pages/[episode].astro | 650 +++- packages/starpod/src/pages/about.astro | 250 +- .../src/pages/api/cues/[episode].json.ts | 23 + packages/starpod/src/pages/contact.astro | 19 +- packages/starpod/src/pages/for-llms.astro | 78 +- packages/starpod/src/pages/index.astro | 23 +- packages/starpod/src/styles/buttons.css | 43 - packages/starpod/src/styles/episode.css | 2097 ++++++++++++ packages/starpod/src/styles/explorer.css | 2877 +++++++++++++++++ packages/starpod/src/styles/global.css | 102 +- packages/starpod/src/styles/gradient-icon.css | 45 - packages/starpod/src/styles/interactions.css | 238 ++ packages/starpod/src/styles/people.css | 118 + packages/starpod/src/styles/player.css | 2427 ++++++++++++++ packages/starpod/src/styles/rail.css | 1808 +++++++++++ packages/starpod/src/styles/shell.css | 976 ++++++ packages/starpod/src/styles/stage.css | 305 ++ packages/starpod/src/styles/tailwind.css | 68 +- packages/starpod/src/styles/tilt.css | 77 + packages/starpod/src/styles/tokens.css | 252 ++ packages/starpod/src/styles/worlds.css | 480 +++ packages/starpod/src/svgs/404-dark.svg | 6 +- packages/starpod/src/svgs/404-light.svg | 6 +- 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/ufo-dark.svg | 14 +- packages/starpod/src/svgs/ufo-light.svg | 14 +- packages/starpod/src/svgs/youtube.svg | 4 +- packages/starpod/src/utils/config.ts | 15 +- packages/starpod/src/utils/playable.ts | 31 + pnpm-lock.yaml | 33 +- 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 | 40 +- starpod.config.ts | 4 +- tests/e2e/episode.spec.ts | 581 +++- tests/e2e/explorer.spec.ts | 774 +++++ tests/e2e/index.spec.ts | 4 +- tests/e2e/player.spec.ts | 302 ++ tests/e2e/shell.spec.ts | 917 ++++++ tests/unit/ForwardButton.test.tsx | 92 - tests/unit/FullPlayButton.test.tsx | 133 +- tests/unit/Island.test.tsx | 365 +++ 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/Scrubber.test.tsx | 53 + tests/unit/SearchButton.test.tsx | 37 +- tests/unit/SearchDialog.test.tsx | 199 +- tests/unit/Slider.test.tsx | 146 - tests/unit/cast.test.ts | 216 ++ tests/unit/config.test.ts | 16 + tests/unit/cues.test.ts | 55 + tests/unit/delight.test.tsx | 125 + tests/unit/engine-recover.test.ts | 142 + tests/unit/explorer-query.test.ts | 101 + tests/unit/feed-media.test.ts | 47 + tests/unit/position.test.ts | 14 + tests/unit/propflip.test.ts | 111 + tests/unit/publish.test.ts | 66 + tests/unit/queue.test.tsx | 300 ++ .../unit/rehype-transcript-timestamps.test.ts | 110 +- tests/unit/seek-chip.test.tsx | 105 + tests/unit/stubs/astro-transitions-client.ts | 2 + tests/unit/test-setup.ts | 20 + tests/unit/tone-worker.test.ts | 25 + tests/unit/transcript.test.ts | 61 +- vitest.config.ts | 4 + 181 files changed, 31563 insertions(+), 5286 deletions(-) create mode 100644 packages/starpod/.impeccable/config.json create mode 100644 packages/starpod/.impeccable/design.json create mode 100644 packages/starpod/.impeccable/surfaces/src-layouts-layout-astro.md create mode 100644 packages/starpod/DESIGN.md create mode 100644 packages/starpod/PRODUCT.md 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 create mode 100644 packages/starpod/src/components/PersonFace.astro delete mode 100644 packages/starpod/src/components/Player.tsx create mode 100644 packages/starpod/src/components/episode/BarPlay.tsx delete mode 100644 packages/starpod/src/components/episode/CreatorsAndGuests.astro create mode 100644 packages/starpod/src/components/episode/LiveTurn.tsx create mode 100644 packages/starpod/src/components/episode/Onward.astro create mode 100644 packages/starpod/src/components/episode/People.astro create mode 100644 packages/starpod/src/components/episode/SectionBar.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/episode/SpeakerCard.tsx create mode 100644 packages/starpod/src/components/episode/SponsorCards.astro create mode 100644 packages/starpod/src/components/episode/Tiles.astro create mode 100644 packages/starpod/src/components/episode/focus.ts create mode 100644 packages/starpod/src/components/episode/speaking-source.ts create mode 100644 packages/starpod/src/components/episode/speaking.ts create mode 100644 packages/starpod/src/components/episode/split.ts create mode 100644 packages/starpod/src/components/explorer/Card.astro create mode 100644 packages/starpod/src/components/explorer/Hero.astro create mode 100644 packages/starpod/src/components/explorer/Toolbar.astro create mode 100644 packages/starpod/src/components/explorer/archive.ts create mode 100644 packages/starpod/src/components/explorer/explorer.ts create mode 100644 packages/starpod/src/components/explorer/icons.tsx create mode 100644 packages/starpod/src/components/explorer/query.ts create mode 100644 packages/starpod/src/components/icons.tsx create mode 100644 packages/starpod/src/components/media/Island.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/board.ts 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/pip.ts create mode 100644 packages/starpod/src/components/media/position.ts create mode 100644 packages/starpod/src/components/media/publish.ts create mode 100644 packages/starpod/src/components/media/shortcuts.ts create mode 100644 packages/starpod/src/components/media/stage-light.ts create mode 100644 packages/starpod/src/components/media/tone-worker.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/motion/propflip.css create mode 100644 packages/starpod/src/motion/propflip.ts create mode 100644 packages/starpod/src/pages/api/cues/[episode].json.ts delete mode 100644 packages/starpod/src/styles/buttons.css create mode 100644 packages/starpod/src/styles/episode.css create mode 100644 packages/starpod/src/styles/explorer.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/people.css create mode 100644 packages/starpod/src/styles/player.css create mode 100644 packages/starpod/src/styles/rail.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/tilt.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/e2e/explorer.spec.ts create mode 100644 tests/e2e/player.spec.ts create mode 100644 tests/e2e/shell.spec.ts delete mode 100644 tests/unit/ForwardButton.test.tsx create mode 100644 tests/unit/Island.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 create mode 100644 tests/unit/Scrubber.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/engine-recover.test.ts create mode 100644 tests/unit/explorer-query.test.ts create mode 100644 tests/unit/feed-media.test.ts create mode 100644 tests/unit/position.test.ts create mode 100644 tests/unit/propflip.test.ts create mode 100644 tests/unit/publish.test.ts create mode 100644 tests/unit/queue.test.tsx create mode 100644 tests/unit/seek-chip.test.tsx create mode 100644 tests/unit/stubs/astro-transitions-client.ts create mode 100644 tests/unit/tone-worker.test.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 `