Skip to content

Agentic UI: Integrate the site overview, sharing, and sync progress - #4601

Draft
shaunandrews wants to merge 25 commits into
stu-2162-site-header-actionsfrom
claude/site-overview-wp-admin-redesign-e11a6d
Draft

Agentic UI: Integrate the site overview, sharing, and sync progress#4601
shaunandrews wants to merge 25 commits into
stu-2162-site-header-actionsfrom
claude/site-overview-wp-admin-redesign-e11a6d

Conversation

@shaunandrews

@shaunandrews shaunandrews commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

Related issues

How AI was used in this PR

Built and iterated with Claude Code and Codex across repeated design, implementation, test, and live-browser passes. I directed the hierarchy and interaction details, reviewed each rendered revision, and used the combined branch to reconcile the four overlapping explorations.

Proposed Changes

This is the top integration layer of a stacked design exploration.

Stack order:

  1. Agentic UI: Add Connections to site overview #4474 — Connections on the overview
  2. Agentic UI: Add preview sites to site overview #4483 — Preview sites on the overview
  3. Design Exploration: Replace the site dropdown with a permanent site header #4400 — Persistent site header with Share and Sync dialogs
  4. Agentic UI: Integrate the site overview, sharing, and sync progress #4601 — Integrated overview polish, reusable sharing controls, and operation progress (this PR)

This layer turns the lower-level explorations into one coherent site-management experience.

Overview hierarchy

  • Give About, Connections, and Preview sites separate cards with headings outside each card.
  • Keep the detail column readable with a smaller max width and delay the stacked responsive layout so About, connections, and previews stay visible sooner.
  • Move Open in to the shared site header and remove the duplicated Overview section.
  • Put creation actions in card footers, use WPDS buttons/badges/tooltips, and keep empty-state copy free of orphaned final words.
  • Add loading states so Connections and Preview sites do not flash their empty states while data resolves.

About and admin access

  • Replace the oversized WP Admin card with compact username/password controls inside About.
  • Show the real site thumbnail and reveal Open site on hover/focus.
  • Load real theme metadata and thumbnails through both browser and desktop connectors.
  • Group password visibility under a menu section with explicit Hide and Show choices.

Connections and Sync

  • Present Push, Pull, and Copy URL in the same order as the Sync dialog.
  • Open the same selective Sync dialog from the connection row, preselected to that site and direction.
  • Support multiple live-site connections without hiding them behind a single menu.
  • Show the active connection's message, percentage/indeterminate bar, and Pushing/Pulling badge.
  • Keep a persistent sidebar notice updated through the full push/pull lifecycle, then resolve it to success, cancellation, or failure.

Preview sites and Share

  • Reuse one Preview sites list and action implementation in both Overview and the Share dialog.
  • Clarify actions with Open, Update/Republish, Copy URL, Delete, and Delete all expired.
  • Remove Copy URL from expired previews and place New preview in the card/dialog footer.
  • Show an optimistic in-list publishing row plus the same persistent progress notice while a preview is created or updated.

Current integrated UI

The progress screenshot stages the same 42% push state used by the automated coverage: the matching connection row and persistent sidebar notice show the same status. Every image below is a native Retina capture rather than an enlarged browser thumbnail.

Overview · light Overview · dark
Final overview in light mode Final overview in dark mode

Inline sync progress and persistent sidebar notice

Site header Connections
Persistent site header Connections card

Preview sites card

Shared Preview sites list in Share

Light Dark
Share dialog in light mode Share dialog in dark mode

Selective Sync

Light Dark
Selective Sync dialog in light mode Selective Sync dialog in dark mode

Testing Instructions

  1. Run npm run cli:build:ui && node apps/cli/dist/cli/main.mjs ui --no-open and open http://localhost:8081.
  2. Open Overview for sites with zero, one, and multiple connections/previews.
  3. Confirm loading states appear before data and empty states appear only after an empty result.
  4. Exercise Connect site, New preview, Delete, Delete all expired, and every row tooltip.
  5. Open Share from the header and confirm it renders the same preview rows and actions as Overview.
  6. Open Sync from the header and from both Push and Pull row actions. Confirm the target/direction and selective file/database choices match.
  7. Start preview and sync work. Confirm the row progress and persistent notice stay in agreement until success, cancellation, or error.
  8. Check wide and narrow layouts in light, dark, and a representative RTL locale.

Automated verification on this integrated head:

  • npx eslint --fix on the modified files
  • npm run typecheck
  • 132 focused overview, toolbar, connector, preview, sync-activity, and local-server tests
  • npm run cli:build:ui
  • Live browser verification in light, dark, and Hebrew RTL at 100% zoom

Pre-merge Checklist

  • Have you checked for TypeScript, React or other console errors?

…ntrols in About

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@shaunandrews
shaunandrews marked this pull request as ready for review August 19, 2026 16:44
@shaunandrews
shaunandrews requested review from a team and katinthehatsite August 19, 2026 16:44

@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.

I like the minimalistic design and thanks for adjusting it, I was mostly going rogue and adding functionality when adding the initial PR 🙈

I see a couple of minor things. For example, when the Hide password is activated and the checkmark goes away, it looks like the option is mistaligned because of the gap in front:

Image

Also, I am finding it a bit strange that the email for login and the admin password are split in the UI. This is the information that usually goes together and the user uses together to log in etc. What do you think?

shaunandrews and others added 22 commits September 4, 2026 13:16
…ntrols in About

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
# Conflicts:
#	apps/ui/src/components/site-overview-view/about-admin.module.css
#	apps/ui/src/components/site-overview-view/about-admin.tsx
#	apps/ui/src/components/site-overview-view/cards.module.css
#	apps/ui/src/components/site-overview-view/index.test.tsx
#	apps/ui/src/components/site-overview-view/index.tsx
@shaunandrews
shaunandrews requested a review from a team as a code owner September 4, 2026 20:15
@shaunandrews
shaunandrews changed the base branch from trunk to stu-2162-site-header-actions September 4, 2026 20:15
Comment thread apps/local/src/index.ts Fixed
@shaunandrews shaunandrews changed the title Agentic UI: Replace the oversized WP Admin card with compact login controls Agentic UI: Integrate the site overview, sharing, and sync progress Sep 4, 2026
@shaunandrews
shaunandrews marked this pull request as draft September 4, 2026 20:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants