> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cubic.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Grouped changes

> Read related changes together, with explanations beside the code.

A PR often changes several files to do one thing. cubic groups those files together and orders
them for review, so you can follow the change across the codebase.

For example, a PR that adds coupon codes to checkout might change a coupon lookup, the pricing
math, a checkout API, and a checkout page. cubic puts the lookup and pricing first, then the API,
then the page, so each group builds on the one before it.

<img src="https://mintcdn.com/cubic-2/lOaRpcHrs43-yDrv/code-review-platform/images/grouped-changes.png?fit=max&auto=format&n=lOaRpcHrs43-yDrv&q=85&s=de4403e90a72e32c2792116720521369" alt="The Coupon Lookup Logic group with its explanation and diff, beside a file list of four groups in review order" className="border border-zinc-800 rounded-lg" width="2220" height="1056" data-path="code-review-platform/images/grouped-changes.png" />

## Follow the review order

In the **Changes** tab, choose **Grouped** at the top of the file list. Each group has a name
that describes the change. Open a file to jump to its diff, or read through the group in order.

cubic orders the groups, and the files in each group, for a first read. Code that defines
behavior, such as schema changes, API contracts, and core logic, comes first. Tests and generated
files such as lockfiles usually come later.

## Read the explanations

For members on screens 768 pixels wide and up, a card at the top of
[AI chat](/code-review-platform/ai-sidebar) shows the group you're reading, with its name, a short
explanation, and its size. The card changes when you scroll into the next group, and its arrows
move between groups. Public viewers and smaller screens see the explanation beside each group.

The card also lists the group's review decisions. Click a decision's file and line to jump to it.

## Read a large PR in chapters

On a PR with more than 50 files, **Changes** shows one group at a time, so the page doesn't load
every file at once. Use the group arrows or the file list to move to the next group. Until cubic
finishes grouping the files, the PR is split into pages of files, such as **Files 1–44**, and the
groups replace them when they're ready.

For a deeper walkthrough, ask [AI chat](/code-review-platform/ai-sidebar) to **"tour this PR"**.
The tour follows the review order, opens each file, and explains what to check.

## Track your progress

When you finish reading a file, mark it **Viewed**. To mark every file in a group at once, mark
the group **Viewed**. cubic then moves you to the next group.

## Browse by folder

To see the changed files in their directory structure, switch to **Tree**. You can also search the
file list to jump to a file by name.

To focus on the implementation, choose **Diff settings > Hide test files** from the PR actions
menu. Show the tests again when you're ready to review them.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.