Skip to content

Show the current interface on the homepage, README and demo - #141

Open
cu1ch3n wants to merge 3 commits into
mainfrom
docs/current-interface-showcase
Open

cu1ch3n wants to merge 3 commits into
mainfrom
docs/current-interface-showcase

Conversation

@cu1ch3n

@cu1ch3n cu1ch3n commented Nov 11, 2026

Copy link
Copy Markdown
Member

The homepage windows, the README images and the site's link card now show the interface as it is on main today, ahead of 0.10.0.

What changed

Homepage windows (site/index.html, site/style.css)

The opening window and the three feature windows are redrawn from the current app. They are still HTML and CSS, not screenshots.

  • Desktop
    • The 46px toolbar row carries the window controls, as the macOS app now does.
    • The toolbar has PDF | Changes, the review counter with Accept all and Reject all, Review / Split / Chat, the New task tab and the green compile button.
    • The marking tools' rail is drawn; Region is selected while a box is drawn, and Edit source is on the manuscript.
    • The change header is the viewer's: arrows, the source location and icon actions, with uppercase BEFORE / AFTER labels.
    • The chat shows the notes message, the agent's edit as a tool line, notes added to the task waiting above the composer, review feedback waiting inside the composer, and the composer's attach, agent menu and grey/blue send.
  • Commit window: it is now Version Management: the branch, the commit box whose single button goes Commit → Sync ↑1 → Synced, staged changes and the version history. It replaces the old custom Git panel.
  • Phone widths draw the phone app: the navigation bar with its segmented control (Review | Chat, PDF | New task), the one-row toolbar, the marking capsule, and the change's decisions in a capsule floating over the page. The PDF and the chat take turns, and the animated rounds switch between them. The capsule's ✓ / ✕ work in the opening window.
  • Narrow desktop windows drop toolbar labels, then the rail, as the app does in a narrow window.
  • Translations: new labels reuse the app's own translations for all ten languages; zh-CN comes from the inline Chinese. The seven strings only the old drawings used are removed, along with their translations and state.
  • Papilot's small card in "Why" gains a hint of the toolbar and the source action.

README showcase (docs/assets/readme-showcase/)

All 24 images are regenerated under the same filenames, so the README markup is unchanged.

  • scripts/capture-readme-showcase.mjs was rebuilt from the 2026-11-05 session that made the current images and is now committed. It captures hero* and paradigm* from the homepage's own windows: light and dark, desktop and phone, English and zh-CN.
  • scripts/capture-readme-review.mjs was rebuilt the same way and updated for today's UI and API. It takes the real screenshots: notes-app*, plus the review shown inside the paradigm card.
    • Desktop runs as the macOS shell, so the window controls sit in the toolbar row with no separate title bar.
    • Phone captures are 430px wide, where the whole marking capsule fits.
  • npm run readme:showcase runs both, and the contributing guide points to it.
  • docs/assets/social-preview.png (the site's og:image) is replaced. It still showed the 0.7 interface and the old "A Cursor-like workspace" tagline; it now shows the homepage headline and window.

Demo (/demo)

No change. Its chrome is built from the app, and the fixtures still work and read well with the new UI.

The example paper's Figures 1 and 2 embed the old README images. Refreshing them means running npm run build:playground-example. Figure 1 also has to shrink to 0.8\linewidth to keep the paper on two pages, and the run rewrites about 37 MB of examples/playground-paper/preview. That is left out of this pull request.

How it was checked

  • npm run test:site, npm run i18n -- check, npm run i18n:check-app, npm run typecheck and npm run test:playground all pass.
  • Two site checks were updated:
    • The pane check measures Version Management's history instead of the removed PDF pane.
    • The theme check covers the composer's review draft instead of the removed "Send feedback" bar.
  • Every window was checked at 1440, 1280, 1100, 961, 800, 390 and 320px, in light and dark, English and zh-CN, both still and mid-animation, with no sideways overflow in any of the 11 languages.
  • The homepage was also checked in WebKit with iPhone emulation and in Safari on the iOS Simulator.
  • Every regenerated README image was reviewed by eye.

Noticed in the app (not changed here)

  • Phone marking capsule: since the Edit source tool was added, the capsule needs about 409px. At 390px (iPhone 15–17) its items scroll sideways with no visible hint, and Redo shows half cut.
  • Changes view: the section title appears twice, as a small-caps heading above the page and the typeset heading inside it.

The opening window and the three feature windows now look like the app
as it is today:

- The 46px toolbar row with the window controls in it, the PDF | Changes
  switch, the review counter with Accept all and Reject all, and the
  task's Review, Split and Chat layouts.
- The marking tools' rail, with the Region tool chosen while a box is
  drawn, and the Edit source tool on the manuscript.
- The change header as the viewer shows it: arrows, the source location
  and icon actions; uppercase Before and After labels.
- The chat's notes message, the agent's edit as a tool line, notes added
  to the task waiting above the composer, review feedback waiting in the
  composer, and the composer's attach, agent menu and send.
- Version Management instead of the old Git panel: the branch, the
  commit box whose one button commits and then syncs, staged changes
  and the version history.

On a phone the windows are the phone app: the navigation bar's
segmented control, a one-row toolbar, the marking capsule and the
change's decisions in a capsule floating over the page; PDF and chat
take turns. Narrow desktop windows drop labels and then the rail, as the
app does. New labels reuse the app's own translations.
Both capture scripts are back in the repository, and every showcase
image is regenerated from them:

- hero*.png and paradigm*.png come from the homepage's own windows
  (scripts/capture-readme-showcase.mjs), so they show the redrawn
  toolbar, rail, review and chat, and the phone app at phone width.
- notes-app*.png and the review inside the paradigm card are real
  screenshots of today's UI (scripts/capture-readme-review.mjs): the
  Manuscript with a region note and a highlight added to a new task, and
  a task's typeset review. Desktop captures run as the macOS shell, so
  the window controls sit in the toolbar row as in the app, with no
  separate title bar. Phone captures are 430px wide, where the whole
  marking capsule fits.
- docs/assets/social-preview.png, the site's link card, now shows the
  homepage headline and window instead of the 0.7 interface.

The review script answers every request the UI makes today, fails on
any it does not, and uses a one-page example paper whose change opens a
subsection, so the change card sits at the top of the review.
The capture scripts are documented where interface changes are, so they
do not become orphans: the contributing guide points to the command.

This branch has not been deployed

No deployments
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