Skip to content

docs(051): README hero — frosted-tiles banner + demo GIF#488

Merged
Dumbris merged 14 commits into
mainfrom
feat/051-readme-hero-demo
May 21, 2026
Merged

docs(051): README hero — frosted-tiles banner + demo GIF#488
Dumbris merged 14 commits into
mainfrom
feat/051-readme-hero-demo

Conversation

@Dumbris
Copy link
Copy Markdown
Member

@Dumbris Dumbris commented May 21, 2026

Implements specs/051-readme-hero-demo (brainstormed design + plan committed in-branch).

What

A CodexBar-style README hero, plus a scripted pipeline to regenerate the assets.

  • docs/social.htmldocs/social.png — frosted-tiles hero banner ("Supercharge AI Agents, Safely", blue→green on navy, 4 capability pills). Rendered via headless Chromium. Doubles as the GitHub social-preview image.
  • docs/demo.gif — one cohesive ~21s demo (860×538, 7.3MB): tray menu → server dashboard (federation) → tools (discovery) → activity log (audit, with a sensitive-data flag) → quarantined-server detail (security). Tray via the mcpproxy-ui-test MCP; web UI via Playwright video; stitched with ffmpeg.
  • scripts/demo/render-banner.sh, capture-tray.md, capture-webui.spec.ts + playwright.config.ts, build-demo.sh, run-order README.md. Assets regenerate, not hand-made once.
  • README hero rewrite — H1 + tagline + badge row + banner + GIF + links. Old externally-hosted thumbnails removed; YouTube link demoted to a one-liner. Everything from "Why MCPProxy?" down unchanged.

Demo provenance (clean re-record)

  • Web beats come from an isolated throwaway core (5 neutral demo servers: filesystem/fetch/time/everything connected, memory quarantined) — no personal data. Activity was populated by calling tools through the proxy so the log shows real successes + a flagged AWS-key detection.
  • Tray still (beat 1) is reused from the maintainer's real app (per the chosen "real tray + clean web" option). It shows 11/25 servers while the web beats show 5 — a known cosmetic mismatch; a fully-clean tray would need a brief live-config swap.

Notes for review

  • Badge row overlaps PR chore: OSS repo hygiene — CoC, issue templates, dependabot, security policy #487. Whichever merges second resolves the README-top conflict; this branch's hero already includes the badges.
  • demo.webp not shipped — ffmpeg 8.0's libwebp animated encoder hits an internal threading bug even single-threaded; build-demo.sh treats webp as non-fatal. The GIF is the README embed.
  • build-demo.sh realities: tray beat is a single Ken-Burns still (UI-test MCP can't screenshot expanded submenus); concat uses the filter with per-input setsar=1 (the demuxer -c copy silently dropped mismatched segments); portable array fill (macOS bash 3.2 has no mapfile).
  • The Playwright capture seeds the API key into localStorage and points at the demo core via MCPPROXY_BASE_URL (the default is :8080).

Manual follow-up (cannot be scripted)

  • Upload docs/social.png to Settings → Social preview to control HN/Slack/X unfurls.

@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented May 21, 2026

Deploying mcpproxy-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 6fac614
Status: ✅  Deploy successful!
Preview URL: https://3694e19f.mcpproxy-docs.pages.dev
Branch Preview URL: https://feat-051-readme-hero-demo.mcpproxy-docs.pages.dev

View logs

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 21, 2026

📦 Build Artifacts

Workflow Run: View Run
Branch: feat/051-readme-hero-demo

Available Artifacts

  • archive-darwin-amd64 (26 MB)
  • archive-darwin-arm64 (23 MB)
  • archive-linux-amd64 (15 MB)
  • archive-linux-arm64 (13 MB)
  • archive-windows-amd64 (26 MB)
  • archive-windows-arm64 (23 MB)
  • frontend-dist-pr (0 MB)
  • installer-dmg-darwin-amd64 (20 MB)
  • installer-dmg-darwin-arm64 (18 MB)

How to Download

Option 1: GitHub Web UI (easiest)

  1. Go to the workflow run page linked above
  2. Scroll to the bottom "Artifacts" section
  3. Click on the artifact you want to download

Option 2: GitHub CLI

gh run download 26241282640 --repo smart-mcp-proxy/mcpproxy-go

Note: Artifacts expire in 14 days.

Dumbris added 2 commits May 21, 2026 15:47
…tivity

- Boot throwaway core with neutral demo servers (filesystem/fetch/time/everything;
  memory quarantined) instead of the real 25-server app for the web beats.
- Generate real activity by calling tools through the proxy so the activity log is
  populated (successes + a sensitive-data flag), not near-empty.
- Spinner/auth-modal/onboarding guards in the capture so no loading states are filmed.
- build-demo.sh: 5-segment stitch (tray still + servers/tools/activity/memory),
  portable array (no mapfile; macOS bash 3.2).
@codecov-commenter
Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Dumbris added 3 commits May 21, 2026 16:13
…drawer; drop tools search

- Tray beat: replace constant Ken-Burns zoom with a 3-phase animation — roll the
  menu down, highlight the 'Open Web UI' item (macOS-style blue selection), then a
  1s shake. Built from the still in ffmpeg (segA roll / segB highlight-swap / segC shake).
- Activity beat: open the detail drawer on the newest Tool Call (the sensitive-data
  echo) to show full event details incl. the detection.
- Tools beat: drop the search-typing scene; show the tool list + approval states.
… cross-platform messaging

- demo.gif: drop the tray beat — now 4 web-UI beats (servers/tools/activity/security).
- social.png banner: use the real logo.svg (MCP shield) instead of the emoji.
- README: add static macOS screenshots (menu-bar app + activity log) and clarify the
  core is a single cross-platform binary (macOS/Linux/Windows) with the web UI embedded;
  macOS additionally ships an optional menu-bar app.
- build-demo.sh: web-only 4-segment stitch; scripts/demo/README updated.
@Dumbris Dumbris merged commit 25731da into main May 21, 2026
24 checks passed
@Dumbris Dumbris deleted the feat/051-readme-hero-demo branch May 21, 2026 17:20
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