Reviewable Units - Assert Docs

Assert groups related changes into clusters that can span multiple files. For example, a migration, the API that uses it, and the UI that calls that API can be one cluster. Each cluster has a summary of its purpose.

Tanner Linsley's TanStack Router pull request, with three clusters in the sidebar and its diff alongside

Browsing clusters

Open Clusters in the sidebar and choose a cluster to see its summary and a diff of only its changes. Large clusters are split into smaller child clusters. Choose All changes to see the full diff. A file can appear in several clusters when it contains changes with different purposes.

Cluster hierarchy and file list alongside the focused diff

Tracking progress

Press R to mark code reviewed. The sidebar shows your progress, and the sibling shortcuts go to the next unreviewed cluster.

Action	Shortcut
Toggle the left sidebar	⌥B
Enter a child cluster	G, then ↓
Return to the parent cluster	G, then ↑
Next / previous unreviewed sibling	G, then → / G, then ←
Mark the selection reviewed	R

Your progress carries over when new commits arrive; see Re-review. To submit feedback, see Finish your review.

Customizing clusters

You can configure how Assert groups changes, for example to keep migrations with their queries or tests with the behavior they cover. See cluster customization. For changes to UI components, see UI previews.