Skip to content

feat(ui): a static click-through DuckShop demo for the website - #1448

Merged
kvlonge merged 3 commits into
mainfrom
feat/ui-demo
Nov 13, 2026
Merged

kvlonge merged 3 commits into
mainfrom
feat/ui-demo

Conversation

@kvlonge

@kvlonge kvlonge commented Nov 13, 2026

Copy link
Copy Markdown
Contributor

Why

A first user should be able to click through the UI on a real project before installing anything: a static demo at sqlbuild.com/demo, with no server behind it.

Changes

  • The demo is the normal web UI. Its server client answers from ui/demo/recording.json.gz, a recording of DuckShop on sqb dev: clean runs, a marts run where dim_carriers fails with a readable error, and the run after the fix. Recorded times move forward so the newest run reads as minutes ago.
  • Plan previews and the job-run and rerun review pages replay the recorded plans. Every write is refused with a read-only message, and a banner says the demo is read-only.
  • ui/scripts/record-demo.mjs rebuilds the recording from browser HARs by asking a running sqb dev for each read. demo-pages.mjs lays it out for a host with no single-page fallback.
  • The website workflow builds the demo into /demo, and now also runs when ui/ changes.
  • The sidebar fills its parent so it fits under the banner.
  • Fix: links inside clickable table rows stopped the click from propagating, so each reloaded the whole app. Rows now ignore clicks on links and controls inside them, as the runs list did.
  • The top bar shows the deployed version on a live server too, not only on mock data, and a long location name truncates.

Verification

  • make check-ci passes on the final head.
  • UI: npm run check and the unit tests pass, including new replay tests for time shifting, paging, unrecorded items, write refusal and plan ids.
  • Built the demo, served it statically with no server, and opened every page: all render recorded data except Providers ("not available", as on a server without that read). A node with no recorded detail shows its own facts, never another node's. Link check: 0 broken links.
  • Top bar checked at 1280 and 1024 px on live and mock. Clicked links and rows on each changed list: every one navigates in-app, and a link inside a row opens the link's page, not the row's.

The demo is the web UI with the server client replaying a recording of
DuckShop on sqb dev, moved forward in time and refusing every write. The
website workflow builds it under /demo.
Links in clickable rows stopped the click from propagating so the row would not also open, which
also kept it from SvelteKit's router, so every such link reloaded the whole app. Rows now ignore
clicks on links and controls inside them, as the runs list already did.
The top bar read the version from the bootstrap, which only the mock data
fills. It now reads the location's newest snapshot, and again when a new
version is published.
@kvlonge kvlonge added the full-verify Run the full Verify matrix on this pull request label Nov 13, 2026
@kvlonge
kvlonge enabled auto-merge November 13, 2026 14:22
@kvlonge
kvlonge added this pull request to the merge queue Nov 13, 2026
Merged via the queue into main with commit 6251280 Nov 13, 2026
36 of 57 checks passed
@kvlonge
kvlonge deleted the feat/ui-demo branch November 13, 2026 16:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

full-verify Run the full Verify matrix on this pull request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant