Skip to content

Prototype (b): first-run guided tour ​

Branch proto/tour. One line: a 12-step, about 5-minute tour that walks a first-time visitor through one whole task — finding the InterPARES archival dataset and seeing how an analysis reaches it without the records leaving — with the page dimmed and clicks paused, so nothing can happen by accident.

  • Opens by itself on the first visit; "Guide" (?) in the header reopens it, resuming where the viewer stopped. Progress is kept only in the browser.
  • Steps: welcome → Catalogue → search box → dataset page (title and description, custodian, identifiers) → compute panel (records stay put, compute rooms, approved algorithms, the one step that needs a wallet) → Connect Wallet → finish (link to the InterPARES Trust AI terminology).
  • Each step explains the screen in archival terms; three steps carry a green "is it safe?" note. ja/en. Phones get a bottom sheet.
  • Text: content/firstRunTour.json / .ja.json. Code: src/components/FirstRunTour/. Highlight targets are data-tour attributes added to 7 existing components (no hashed class names).
  • Sample dataset: did:op:65e78d53…f43d (Pontus-X devnet). If it is removed, the tour shows a "not showing yet" card with Skip.

Known limits: the search step only points at the box — catalogue search returns nothing until the in-house metadata server is rebuilt (the public Pontus-X cache answers 405 to the query this fork sends). Uses CSS :has() for three compute-form targets (all current browsers).

Screenshots: welcome-ja.png, record-en.png, access-ja.png, wallet-step-ja.png, phone-environment-ja.png.

Source: docs/prototypes/tour/

Screenshots ​

access-ja.png

access-ja.png

phone-environment-ja.png

phone-environment-ja.png

record-en.png

record-en.png

wallet-step-ja.png

wallet-step-ja.png

welcome-ja.png

welcome-ja.png

Independent notes by Satoru Nakamura (University of Tokyo; visiting UBC). Not an official Clio-X or Ocean Protocol site.