@import url("https://fonts.googleapis.com/css2?family=Inter:wght@300;500;700&display=swap");

body {
  font-family: "Inter", sans-serif;
}


A practical starter guide for trunk-based development and stacking.

Overview

Learn to Stack

Graphite

Learn how to create, review, and merge stacked pull requests with Graphite.

Graphite is built on top of GitHub's APIs, so you need to provide Graphite access to your GitHub resources to create, review, and merge PRs.

Authenticate With GitHub

Answers to common questions when getting started with Graphite.

Onboarding FAQs

Learn how to configure your repository settings on GitHub for the best experience stacking with Graphite.

Configure GitHub Repository Settings

Learn how to enable commit signing in Graphite.

Enable Signed Commits

Learn how to install & authenticate Graphite's CLI to start creating stacked pull requests.

Install & Authenticate The CLI

Update The CLI

Join the Graphite CLI beta test group for early access to the newest features.

Use Beta CLI Releases

Use CLI Binaries

Catch bugs before they ship to production with AI code review

Diamond

Get started with Diamond in under 5 minutes

Setup & configuration

Understanding Diamond's feedback and how to get the most value from it

Review comments

Tailor Diamond to your team's specific needs and coding standards

Customization

Think of the pull request inbox as an "email client" for your PRs—it helps you stay organized and view which PRs need your attention.

Pull Request Inbox

Learn how to review pull requests on the Graphite dashboard.

Review Pull Requests

Learn how to view history of PR in Graphite using versions.

Pull Request Versions

Memes And Macros

Learn how to seamlessly merge a single PR or stack of PRs with Graphite and handle merge conflicts efficiently.

Merge Pull Requests

Learn how to automatically merge PRs with Graphite once all branch protection rules have been met.

Merge When Ready

Learn how to merge a stack of PRs outside of Graphite.

Merge A Stack Of PRs Manually

Mergeability Status Check

Create, stack, and submit pull requests directly from the command line.

CLI Overview

Learn to create stacked pull requests with the Graphite CLI.

Quick Start

This reference documents every command and flag available in Graphite’s command-line interface.

Command Reference

Command Cheatsheet

Learn how to configure the Graphite CLI to customize and speed up your workflow.

Configure The CLI

Basic Tutorials

Learn how to initialize the Graphite CLI in your git repository.

Initialize Graphite In A Repository

Learn to use the Graphite CLI to create a single pull request.

Create A Pull Request

Learn how to create stacked branches with the Graphite CLI.

Create A Stack

Learn how to navigate stacked branches with the Graphite CLI.

Navigate A Stack

Learn how to sync changes from a remote repository with Graphite's CLI, managing branch updates and conflicts.

Sync Changes From A Remote Repository

Learn how to make changes to mid-stack branches and auto-restack seamlessly with Graphite CLI.

Update Mid Stack Branches

Take it to the next level with advanced CLI commands.

Advanced Tutorials

Learn how to track git branches with the Graphite CLI.

Track Branches

Learn to restack Git branches efficiently with Graphite's CLI.

Restack Branches

Learn how to edit the branch order in a stack using Graphite CLI commands.

Edit The Branch Order In A Stack

Learn how to squash, fold, and split changes with the Graphite CLI.

Squash, Fold, And Split Changes

Learn how to work on shared collaborative stacks with other Graphite users.

Collaborate On A Stack

Learn how to develop against multiple trunk branches with the Graphite CLI.

Develop On Multiple Trunk Branches

Personalize your workflow by connecting Graphite to your favorite apps.

Integrations

Not a CLI person? Graphite's VS Code extension lets you create and manage stacked pull requests visually, right from your IDE.

VS Code Extension

Get started using the Graphite VS Code extension to stack pull requests.

Learn to use the Graphite VS Code extension to create a single pull request.

Learn to use the Graphite VS Code extension to create pull requests for a stack.

Create PRs For A Stack

Customize the Graphite VS Code extension.

Configuration

Keep track of all of your PRs from your Mac menu bar.

Menu Bar App (Mac)

Learn how to integrate Graphite with Slack to receive real-time, actionable notifications about your PRs.

Slack Notifications

Learn how to integrate Graphite with Linear to view, link, and create issues associated with pull requests.

Linear

Learn how Graphite's merge queue can help your team merge stacks faster and reduce merge conflicts.

Merge Queue

Set Up The Graphite Merge Queue

Learn how to use the Graphite merge queue in your repo.

Use The Graphite Merge Queue

Learn how to speed up your Graphite merge queue

Merge Queue Optimizations

Learn how to use Graphite with your existing external merge queue.

External Merge Queue Integration (Beta)

Learn how to automate tedious code review tasks like assigning reviewers, adding labels, and more with automations.

Automations

Graphite Protections offers fine-grained control over PR mergeability based on file path, language, team, and more. It is a drop-in replacement for branch protection rules, rulesets,  and CODEOWNERS.

Protections

Learn how to track your team's engineering velocity with Graphite Insights.

Insights

Learn how the stats on Graphite insights are computed.

Insights Stats Definitions

Learn how to troubleshoot missing insights data.

Missing Insights Data

Learn how Graphite prioritizes security to safeguard your source code.

Privacy & Security

Graphite offers a handful of AI features to automate parts of the developer workflow. These features are opt-in and do not store or train on your data.

AI Privacy and Security

Learn how to manage users and billing information for your organization as a Graphite admin.

User permissions

Learn about the default Graphite plan for teams.

Billing & plans

Pricing FAQ

For companies looking to grow with Graphite.

Graphite Core For Startups

Learn how Graphite Enterprise customers can use Graphite with a GitHub Enterpise Server instance.

GitHub Enterprise Server

FAQs

Tips for resolving common Graphite CLI issues.

CLI Troubleshooting FAQs

Learn how to easily share feature requests and bug reports with the Graphite team.

Feature Requests & Bugs

See the history of changes for the Graphite CLI.

CLI Changelog

Discover Graphite CLI v1's revamped command names.

Graphite CLI V1 Command Names

Copy legacy aliases to retain old command names & avoid deprecation warnings in Graphite CLI.

Legacy CLI Command Alias Preset

Learn more about trunk-based development's benefits, best practices, and comparison with Gitflow.

Introduction To Trunk Based Development

Five helpful frameworks for breaking up large changes into stacked PRs.

How To Structure A Stack

Learn best practices to keep in mind when reviewing PRs in a stack.

Best Practices For Reviewing Stacked PRs

Learn the key differences between working with the Graphite CLI vs. vanilla git.

Comparing Git And Gt

Learn more about how to evaluate if Graphite is right for your team.

Evaluating Graphite

One end-to-end tool to simplify and accelerate your team’s developer workflow.

Why You Should Use Graphite

Best practices for teams new to stacking with Graphite.

Setting Up A Proof Of Concept

Learn about the differences between Graphite and other tools for stacking pull requests.

Trunk-based development

Structuring a stack

Best practices for reviewing stacks

Comparing Git and Graphite

Get started

Setup & configuration

Diamond (AI code review)

PR workflows

Stacking (Graphite CLI)

Integrations

Repository management

Administration

References

Learn to Stack