Skip to content

docs(readme): animated feature demos, targeted screenshots, and a CLI cell - #6378

Merged
Kitenite merged 5 commits into
mainfrom
readme-targeted-screenshots
Aug 12, 2026
Merged

Kitenite merged 5 commits into
mainfrom
readme-targeted-screenshots

Conversation

@Kitenite

@Kitenite Kitenite commented Aug 12, 2026 •

Copy link
Copy Markdown
Member

Summary

  • Replaces all 7 README feature screenshots (apps/marketing/public/images/readme/). The old set was seven identical full-window captures of one busy 3-pane layout — the feature being sold was a tiny sliver of each frame. Each image is now a targeted capture where the feature reads large.

Why / Context

The README is our GitHub landing page and the repo converts poorly relative to its traffic. Competitor READMEs (orca, herdr) treat the README as a product landing page with one focused visual per feature. Ours had a feature wall, but every cell showed the same screenshot at full-window zoom.

How They Were Made

  • Staged a demo org in the dev desktop app via CDP: two demo projects, five task workspaces, with real Claude / Codex / OpenCode sessions doing real work — the diff stats, working spinners, done dots, port detection, and rich-input mention chip are all genuine app state, not mockups.
  • Captured at 1120×720 @2x per the changelog screenshot guidance (small viewport so features render large), then ran each source through .github/prompts/beautify-screenshot.ts (flat style, per-feature crop, dither backdrop) and pngquant.
  • No real data appears: demo automations were created through the real API and deleted after; the real sidebar (28 projects) and sessions list were hidden during capture and verified restored.

Per-image targeting:

Image What it now shows
parallel-workspaces Claude mid-task + sidebar with 3 concurrent agents and diff stats
agent-monitoring Tight sidebar crop: working/done dots, agent badges, +433 −3
terminal Split panes + ⌘I rich prompt editor with an @-file mention chip
diff-viewer Full-width diff with changes rail
browser-ports Dev server preview + detected port badge
automations Automations table with schedules and stat cards
command-palette Workspace actions with shortcuts

Testing

  • Image-only change; filenames unchanged so the README references are untouched.
  • Verified each image renders correctly (reviewed all 7 outputs at full size).
  • File sizes: 126–220 KB each (previous set was 131–200 KB).

Summary by cubic

Refreshes the README feature gallery with tighter, flat screenshots and five animated demos so each feature reads at a glance. Replaces static, zoomed‑out stills (some tilted) with focused crops, adds a new Superset CLI row, and trims leaked command‑palette frames from the terminal GIF.

  • Swaps four feature stills to GIFs (parallel workspaces, agent monitoring, terminal, command palette); adds a CLI demo GIF; re-renders three PNG stills flat; removes the superseded PNGs.
  • Updates README image refs and alt text; verified all assets render correctly. Docs-only change (no runtime code).

Written for commit eaeae5f. Summary will update on new commits.

Review in cubic

All seven README feature images were identical full-window captures where
each feature was a tiny sliver of the frame. Retaken via CDP against a
staged demo org (real agent sessions), then cropped per-feature with the
changelog beautifier pipeline and compressed with pngquant.
@coderabbitai

coderabbitai Bot commented Aug 12, 2026 •

Copy link
Copy Markdown
Contributor

Review Change Stack

Important

Review skipped

Review was skipped due to path filters

⛔ Files ignored due to path filters (1)
  • apps/marketing/public/images/readme/terminal.gif is excluded by !**/*.gif

CodeRabbit blocks several paths by default. You can override this behavior by explicitly including those paths in the path filters. For example, including **/dist/** will override the default block on the dist directory, by removing the pattern from both the lists.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: d0197072-240e-4939-a765-4094f0d00d68

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 6e88e1b4-f8ba-41bb-9902-e3769dfbc9dd

📥 Commits

Reviewing files that changed from the base of the PR and between 4014def and ff4bc7d.

⛔ Files ignored due to path filters (9)
  • apps/marketing/public/images/readme/agent-monitoring.gif is excluded by !**/*.gif
  • apps/marketing/public/images/readme/agent-monitoring.png is excluded by !**/*.png
  • apps/marketing/public/images/readme/automations.png is excluded by !**/*.png
  • apps/marketing/public/images/readme/browser-ports.png is excluded by !**/*.png
  • apps/marketing/public/images/readme/command-palette.gif is excluded by !**/*.gif
  • apps/marketing/public/images/readme/command-palette.png is excluded by !**/*.png
  • apps/marketing/public/images/readme/diff-viewer.png is excluded by !**/*.png
  • apps/marketing/public/images/readme/terminal.gif is excluded by !**/*.gif
  • apps/marketing/public/images/readme/terminal.png is excluded by !**/*.png
📒 Files selected for processing (1)
  • README.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • README.md

📝 Walkthrough

Walkthrough

The README replaces four static feature images with animated GIFs and adds a Superset CLI feature section with scripting details, documentation, and a CLI demo.

Changes

README feature showcase

Layer / File(s) Summary
Replace feature demonstrations
README.md
Parallel Workspaces, Agent Monitoring, Built-in Terminal, and Command Palette now use animated GIF demonstrations.
Add Superset CLI showcase
README.md
The README adds Superset CLI scripting details, a documentation link, and an animated CLI demo.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description check ✅ Passed The description explains what changed, why it changed, how assets were created, and how the updates were tested; the checklist is omitted but non-critical.
Title check ✅ Passed The title uses conventional commit format and clearly summarizes the README demo and CLI gallery updates.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch readme-targeted-screenshots

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@cubic-dev-ai cubic-dev-ai Bot 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.

No issues found across 7 files

You’re at about 97% of the monthly reviewed-line limit. You may want to disable incremental reviews to conserve quota. Reviews will continue until that limit is exceeded. If you need help avoiding interruptions, please contact contact@cubic.dev.

Architecture diagram
sequenceDiagram
    participant Dev as "Developer"
    participant App as "Desktop App"
    participant CDP as "CDP Protocol"
    participant API as "Real Backend API"
    participant Store as "Demo Data Store"
    participant Shot as "Capture Pipeline"
    participant Tool as "beautify-screenshot.ts"
    participant PngOpt as "pngquant"

    Note over Dev,PngOpt: README Feature Screenshot Capture Flow

    Dev->>App: Stage demo org (2 projects, 5 workspaces)
    App->>API: Create demo automations
    API->>Store: Persist demo records
    Store-->>API: Records created
    API-->>App: Demo data ready

    Dev->>App: Hide real sidebar (28 projects) & sessions
    App-->>Dev: UI state isolated

    Dev->>CDP: Navigate to feature view (1120x720 @2x)
    CDP->>App: Render targeted UI state
    App-->>CDP: Frame ready (real agent sessions, diff stats, spinners)

    CDP->>Shot: Capture screenshot
    Shot-->>Dev: Raw capture output

    Dev->>Tool: Run flat-style crop & process
    Tool->>Tool: Per-feature crop, dither backdrop
    Tool-->>Dev: Processed image

    Dev->>PngOpt: Optimize PNG
    PngOpt-->>Dev: Final image (126-220 KB)

    Dev->>App: Delete demo automations via API
    App->>Store: Remove demo records
    Store-->>App: Cleanup complete
    App-->>Dev: Verify real data restored

    Note over Dev,PngOpt: All 7 captures follow same pipeline with different feature targets
Loading

Re-trigger cubic

@github-actions

github-actions Bot commented Aug 12, 2026 •

Copy link
Copy Markdown
Contributor

🚀 Preview Deployment

🔗 Preview Links

Service Status Link
Neon Database (Neon) ✅ View Branch
Vercel API (Vercel) ✅ Open Preview
Vercel Web (Vercel) ✅ Open Preview
Vercel Marketing (Vercel) ✅ Open Preview
Vercel Admin (Vercel) ✅ Open Preview
Vercel Docs (Vercel) ✅ Open Preview

Preview updates automatically with new commits

- parallel-workspaces cell is now a live GIF of Claude streaming a task
  with agent status updating in the sidebar
- new "Superset CLI" feature row with a VHS-recorded terminal demo
- all stills re-captured with perspective tilt and tighter feature zooms
@Kitenite

Copy link
Copy Markdown
Member Author

Second pass — motion + flair:

  • Parallel Workspaces is now a GIF (12.5s loop): Claude streams a Stripe migration, MIGRATION.md lands in the Changes panel, and the sidebar diff stats tick up live.
  • New "Superset CLI" feature row with a VHS-recorded terminal demo: superset workspaces create --agent claude → workspace ready → workspaces list with working/review states — mirroring the website's CliDemo.
  • All stills re-shot with perspective tilt and tighter zooms (no more flat mid-window slices). The diff-viewer now shows a real side-by-side red/green diff.

GIF weights: agents-working.gif 690KB, cli-demo.gif 120KB.

@Kitenite Kitenite changed the title docs(readme): retake feature screenshots as targeted staged captures docs(readme): animated demos, tilted screenshots, and a CLI feature cell Aug 12, 2026
…r zooms

- agent-monitoring is now a GIF: the status dot flips from working to
  done as an agent finishes, next to a live diff-stat counter
- terminal is a GIF: typing a follow-up with an @-file mention in the
  rich prompt editor beside a split shell
- command-palette is a GIF: type-to-filter across workspace actions
- diff-viewer, browser-ports, and automations re-rendered flat (no
  perspective tilt) from fresh captures
@Kitenite

Copy link
Copy Markdown
Member Author

Third pass per feedback — no tilt, more motion:

5 of 8 feature cells are now GIFs:

Cell Motion
Parallel Workspaces Claude streaming a migration, diff stats ticking up (690KB)
Agent Monitoring status dot flips working → done as the agent finishes (103KB)
Built-in Terminal typing a follow-up with an @-file mention in the rich editor beside a split shell (450KB)
Superset CLI VHS terminal demo: create workspace → agent starts → list with states (120KB)
Command Palette type-to-filter across workspace actions (270KB)

Stills (diff-viewer, browser-ports, automations) re-rendered flat — tilt removed, fresh captures with tighter zooms. The diff still now shows a genuine side-by-side red/green refactor.

Total GIF weight ~1.6MB.

@Kitenite Kitenite changed the title docs(readme): animated demos, tilted screenshots, and a CLI feature cell docs(readme): animated feature demos, targeted screenshots, and a CLI cell Aug 12, 2026
@Kitenite
Kitenite merged commit 185e295 into main Aug 12, 2026
1 of 2 checks passed

This branch was previously deployed

1 inactive deployment
preview — eaeae5fb Deployed Aug 12, 2026 by Kitenite via Deploy Admin #7546
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.

1 participant