Skip to content

feat(site): demo page; move the Pages client to demo/client/ - #201

Merged
jonocodes merged 4 commits into
mainfrom
feat/demo-page
Nov 19, 2026
Merged

jonocodes merged 4 commits into
mainfrom
feat/demo-page

Conversation

@jonocodes

Copy link
Copy Markdown
Owner

Summary

A click-through demo page, and the Pages client moved somewhere that doesn't read as a usable app.

 jonocodes.github.io/deckd/
 ├── index.html          # homepage: + "Demo" nav link, + "Try the demo" button
+├── demo/
+│   ├── index.html      # pick a window → the live client switches deck
+│   └── client/         # the client on demo fixtures, embed-only
-├── app/                # (was the client)
 └── 404.html            # still the client, so deep links boot
client boot (Pages build only, VITE_DEMO_PAGE set)
  ?demo= / ?playground / ?deck=  → render the client
  anything else                  → location.replace("/deckd/demo/")
daemon-served client             → never redirects (env unset)
  • Demo page: Desktop, Firefox, Gmail, YouTube, Meet, music, "anything else" (trackpad). One iframe per app, kept alive; the landscape/portrait toggle sticks across apps.
  • Homepage trackpad section now pitches the keyboard and voice typing (phone dictation streams in as you talk).
  • Narrow header hides its in-page links (Web apps, FAQ) so it stays on one line.
  • PAGES_HOST=0.0.0.0 just pages serves the preview to other devices (Tailscale).

Stacked on #191, which this carries along.

Evidence

  • Before: /deckd/app/ with no ?demo= showed "Reconnecting…"; the 5-link header overflowed at 390px.
    After: checked in Chromium against just pages:
    • demo page frames all load from /deckd/demo/client/?demo=…; homepage phones too
    • /deckd/demo/client/ and old /deckd/app/ → /deckd/demo/; /deckd/app/?demo=gmail still opens the deck; /deckd/?demo=firefox → demo/client/?demo=firefox
    • orientation: landscape for every app until "portrait" is pressed, then portrait for every app
    • header at 320/390px: no horizontal overflow
  • demoLanding() unit tests (3 new); client 420 tests pass, tsc and eslint clean; scripts/build_pages.sh assembles.

Merge Danger

Door: two-way

Blast Radius: Pages-only

Old /deckd/app/… links still work via the 404 fallback. The client change is gated on VITE_DEMO_PAGE, which only the Pages build sets.

"Your phone becomes…" now cycles phone / tablet / laptop, easing to each
word's width so "becomes" follows without a gap; screen readers hear
"phone, tablet or laptop", and reduced motion keeps "phone".

Drop the "Is it free?" FAQ. Downloads shipped (v20261115.0), so they move
from "coming" to "works today"; "coming" regains per-device decks and
picking between several computers.
The guide's GitHub Pages list is now clickable. The responsive gallery
drops the 390px phone and the 7" tablet, and labels the mpris test
fixture "MPRIS" so it isn't confused with the media showcase deck.
- site/demo/: a click-through demo. Pick a window on a pretend desktop
  (Desktop, Firefox, Gmail, YouTube, Meet, music, anything else) and one
  large live client switches to that deck; a landscape/portrait toggle
  sticks across apps.
- The client on Pages moves from /deckd/app/ to /deckd/demo/client/. It
  only exists for the homepage and the demo page to embed, and "app"
  read like something to use. A visit with nothing to demo (no ?demo=,
  ?playground or ?deck=) forwards to the demo page (VITE_DEMO_PAGE,
  client/src/demo-landing.ts); a daemon-served client never redirects.
- Homepage: Demo link in the header and a "Try the demo" button; the
  narrow header drops its in-page links so it stays on one line. The
  trackpad section now covers the keyboard and voice typing.
- `just pages` takes PAGES_HOST=0.0.0.0 to serve other devices.
@jonocodes
jonocodes merged commit 7476932 into main Nov 19, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant