Skip to content

Agentic UI: Sites and Chat illustrations for the orientation guide - #4441

Open
shaunandrews wants to merge 2 commits into
stu-2016-add-orientation-guidefrom
stu-2016-orientation-illustrations
Open

Agentic UI: Sites and Chat illustrations for the orientation guide#4441
shaunandrews wants to merge 2 commits into
stu-2016-add-orientation-guidefrom
stu-2016-orientation-illustrations

Conversation

@shaunandrews

@shaunandrews shaunandrews commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Related issues

⚠️ Visual change: needs human review in light + dark mode.

How AI was used in this PR

Built and iterated interactively with Claude Code.

Proposed Changes

image image

Replaces the orientation guide's placeholder header art with animated illustrations that show the workbench rather than describe it.

  • Page 1 (sites): a real-looking sidebar row where a cursor drifts in, hovers the site-overview button, then clicks the status button to start the site — stopped → starting → running — with the tooltips it would really show. Loops.
  • Page 2, signed in (chat): a one-time playback of Studio Code — the composer types a prompt, sends it (dropping off-stage and flipping to its busy state) as the prompt becomes a user bubble, the reply streams in, and a tool call appears and keeps working. A subtle Replay control restarts it.

Both are theme-adaptive and respect reduced motion. They're built as a small reusable system (a Stage + Cursor and an id-keyed scene registry) so more scenes can be added without bespoke plumbing. The "manage your site" (overview) and preview illustrations remain placeholders for follow-up.

Testing Instructions

  1. npm run cli:build:ui (the agentic UI isn't rebuilt by the normal dev watcher).
  2. Enable the Agentic UI beta and open a site's workbench.
  3. Help ▸ Getting Started — page 1 shows the sites animation.
  4. Signed in with Studio Code on, page 2 shows the chat animation; the Replay control (top-left) restarts it.
  5. Verify in light and dark, and with reduced motion enabled (scenes settle on a clean static frame).

Pre-merge Checklist

  • TypeScript / lint / build pass for the changed files.
  • Human visual review in light + dark mode.

Replaces the placeholder header slot with a small scene system (Stage + Cursor
primitives, an id-keyed registry) and builds the sites and chat scenes; the
modal's Skip button adapts to dark scenes.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@shaunandrews shaunandrews changed the title Agentic UI: Animated illustrations for the orientation guide Agentic UI: Sites and Chat illustrations for the orientation guide Aug 4, 2026
@shaunandrews
shaunandrews marked this pull request as ready for review August 4, 2026 16:47
Both scenes now run on one timeline clock (useTimeline) with shared helpers
(sample/envelope/span/at) and primitives (Stage/Cursor/Tooltip/StreamingText),
replacing the CSS-keyframe and setTimeout approaches. Reduced motion and replay
are handled centrally.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

@katinthehatsite katinthehatsite left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A subtle Replay control restarts it.

I saw this button on the second page but it was not on the first page:

Image

So it seems that we can replay the second page but not the first one? Should we have it on both pages? I see that the first page loops though. I am wondering if it would be more consistent to have either replay on both or loop on both. What do you think?

@katinthehatsite katinthehatsite left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice, the illustration worked well for RTL ❤️

Image

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.

2 participants