[Design] Viewed file interaction

Proposal

Exploration of a better experience when you mark a file as "Viewed".

  1. Hide the diff when the reviewer marks a file as viewed
    • This allows the reviewer to have the next unviewed files appearing next automatically
    • A filter is introduced to help toggle between the viewed and unviewed files.
    • The filter should remember the last selection to keep that as a user preference. For example the user may want to view the tree as how it is currently and they can achieve that via the "Show all" button.
  2. Show progress of viewed files
    • X of Y viewed along with a progress bar
  3. The reviewer can use an action on the folder bulk action to mark files under that folder as viewed.

Question

  1. Should we call this "Reviewed" or "Mark as reviewed" versus "Viewed"?
    • Decision to call it "Viewed" over "Reviewed" was because many people thought this would affect the “Start a review” feature #17531 (comment 460134020) However Extend "Start a review" to actions that could s... (#509545) proposes the idea that we consider other signals to indicate that a review has started.

Design

  • Figma
  • Prototype

Mockup

image

Video

CleanShot_2025-10-01_at_15.44.11

Edited Oct 01, 2025 by Michael Le
Assignee Loading
Time tracking Loading