Skip to content

docs(readme): redesign README with real Web workbench media - #918

Merged
tt-a1i merged 3 commits into
mainfrom
docs/readme-revamp
Nov 9, 2026
Merged

tt-a1i merged 3 commits into
mainfrom
docs/readme-revamp

Conversation

@tt-a1i

@tt-a1i tt-a1i commented Nov 9, 2026

Copy link
Copy Markdown
Collaborator

Summary

Redesigns README.md and README.zh-CN.md around real OpenPI Web workbench media.

Structure

Media honesty

All screenshots and the animated demo come from the real OpenPI Web host, and every tool call (read, bash, edit, subagents, workflow, node --test) really ran against a demo repo. Model replies come from a scripted local OpenAI-compatible provider so the capture is reproducible, and the README caption says so. The only generated image is the abstract background art behind the hero. No UI was generated.

New assets (docs/assets/readme/, ~1.6 MB, not in npm files)

File Size
hero-dark.webp / hero-light.webp 88 KB / 81 KB
demo-subagents.webp (animated) 763 KB
shot-subagents-{dark,light}.webp 87 KB / 88 KB
shot-changes-{dark,light}.webp 50 KB / 52 KB
shot-trajectory-{dark,light}.webp 88 KB / 85 KB
shot-context-{dark,light}.webp 71 KB / 72 KB
architecture-{dark,light}.svg 11 KB each

Removed (no longer referenced anywhere in the repo)

  • assets/openpi-launch-card-v1.webp
  • assets/readme-hero.svg
  • assets/readme-hero-mobile.svg

These stay because they are still referenced: openpi-product-hero-v2.webp (site og:image), readme-runtime*.svg (USAGE.md) and openpi-package.png (package.json and the contract test).

Checks

bun run check and bun run test pass locally. No web/dist changes.

- New hero (light/dark via <picture>), demo recording, feature grid,
  v1.2.0 highlights, screenshot tour and architecture diagram
- Screenshots and recording are captured from the real OpenPI Web
  workbench against a demo repository (scripted local provider)
- Same structure for README.zh-CN.md; reference sections unchanged,
  Defaults table folded into <details>
- Media lives in docs/assets/readme/ so it is not shipped in the npm package
@github-actions github-actions Bot added documentation Improvements or additions to documentation area:ui Terminal UI, rendering, themes, or visual assets labels Nov 9, 2026
@tt-a1i
tt-a1i merged commit ffc9c62 into main Nov 9, 2026
20 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:ui Terminal UI, rendering, themes, or visual assets documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant