> ## Documentation Index
> Fetch the complete documentation index at: https://ade-ac1c6011-ade-mobile-chat-stability-54bd7ef0.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Stacked lanes

> Use stacked lanes when a large change is easier to review as several dependent PRs.

A stack is a chain of lanes. Each child lane is based on the lane above it instead of directly on `main`.

```text theme={null}
main
  auth-models
    auth-ui
      auth-tests
```

Each lane can become its own PR. Reviewers see small diffs instead of one giant branch.

## Create a stack

<Steps>
  <Step title="Create the base lane">
    Start the first slice from `main` or your default branch.
  </Step>

  <Step title="Create a child lane">
    Select the parent lane and choose **New child lane**.
  </Step>

  <Step title="Repeat only when needed">
    Keep stacks shallow. Two or three levels are much easier to review than six.
  </Step>
</Steps>

## Work with a stack

* Open PRs from bottom to top.
* Child PRs target their parent branch.
* Merge the base PR first.
* Rebase or retarget child PRs after the parent lands.
* Use Graph when the stack gets hard to picture.

## When not to stack

Do not stack unrelated work. If two tasks can merge independently, use two sibling lanes instead.

<CardGroup cols={2}>
  <Card title="Stacked PR guide" icon="layer-group" href="/guides/stacked-prs">
    Follow the end-to-end review flow.
  </Card>

  <Card title="Workspace graph" icon="diagram-project" href="/tools/workspace-graph">
    Visualize stack relationships.
  </Card>
</CardGroup>