---
title: Mergify Documentation
description: Ship code faster with zero broken builds, reliable CI, and optimized monorepo workflows.
suppressTitle: true
---

import Docset from '~/components/DocsetGrid/Docset.astro';
import DocsetGrid from '~/components/DocsetGrid/DocsetGrid.astro';
import CommunityButton from '~/components/CommunityButton.astro';
import Button from '~/components/Button.astro';

<div id="home">
  {/* ---------------- HERO ---------------- */}

  <div class="home-hero">
    <div class="hero-inner">
      <h1 class="content-title">Ship Code Faster, Break Less</h1>
      <div class="tagline content-subtitle">
        Mergify eliminates broken builds, tames flaky tests, and
        cuts CI waste—so your team ships with confidence.
      </div>
    </div>
  </div>

  {/* ---------------- VALUE METRICS ---------------- */}

  <div class="home-metrics">
    <div class="home-metric-card">
      <div class="home-metric-value">3-5x</div>
      <div class="home-metric-label">faster merge throughput</div>
    </div>
    <div class="home-metric-card">
      <div class="home-metric-value">60-90%</div>
      <div class="home-metric-label">CI cost reduction</div>
    </div>
    <div class="home-metric-card">
      <div class="home-metric-value">Zero</div>
      <div class="home-metric-label">broken builds</div>
    </div>
  </div>

  {/* -------------- PROBLEM-SOLUTION CARDS -------------- */}

  <h2 class="home-title">What Problem Are You Solving?</h2>

  <div class="home-problems">
    <a href="/merge-queue" class="home-problem-card">
      <div class="home-problem-title">Broken main branch or slow merges?</div>
      <div class="home-problem-desc">
        PRs pass CI individually but break when merged. Developers wait hours in a serial queue.
      </div>
      <div class="home-problem-cta">Merge Queue →</div>
    </a>
    <a href="/ci-insights" class="home-problem-card">
      <div class="home-problem-title">Flaky tests blocking PRs?</div>
      <div class="home-problem-desc">
        Tests fail randomly, forcing reruns and eroding trust in CI. Hard to track down culprits.
      </div>
      <div class="home-problem-cta">CI Insights →</div>
    </a>
    <a href="/monorepo-ci" class="home-problem-card">
      <div class="home-problem-title">CI waste in monorepos?</div>
      <div class="home-problem-desc">
        Every PR runs the full test matrix even when only one service changed. CI bills spiral.
      </div>
      <div class="home-problem-cta">Monorepo CI →</div>
    </a>
  </div>

  {/* -------------- PRODUCT OVERVIEW -------------- */}

  <h2 class="home-title">Products</h2>

  <DocsetGrid>
    <Docset title="Merge Queue" path="/merge-queue" icon="octicon:git-merge-queue-16">
      Zero broken builds with parallel testing, smart batching, and priority queues.
    </Docset>
    <Docset title="CI Insights" path="/ci-insights" icon="mdi:lightbulb-outline">
      Detect flaky tests, auto-retry failures, and quarantine noisy tests.
    </Docset>
    <Docset title="Monorepo CI" path="/monorepo-ci" icon="tabler:topology-star-ring-3">
      Run only the CI jobs that matter for each pull request.
    </Docset>
  </DocsetGrid>

  {/* -------------- GET STARTED -------------- */}

  <h2 class="home-title">Get Started</h2>

  <div class="home-get-started">
    <Button variant="primary" href="/merge-queue/setup" target="_self">Set up Merge Queue</Button>
    <Button variant="primary" href="/ci-insights" target="_self">Enable CI Insights</Button>
    <Button variant="primary" href="/monorepo-ci/github-actions" target="_self">Configure Monorepo CI</Button>
  </div>

  <a href="https://mergify.com/discovery" class="home-discovery">
    <div class="home-discovery-title">Need help getting started?</div>
    <div class="home-discovery-desc">
      Book a free discovery call with our team to find the best setup for your workflow.
    </div>
  </a>

  {/* -------------- REFERENCE -------------- */}

  <h2 class="home-title">Reference</h2>

  [Configuration](/configuration/file-format) ·
  [Conditions](/configuration/conditions) ·
  [Commands](/commands) ·
  [API](/api) ·
  [Integrations](/integrations)

  <DocsetGrid>
    <Docset title="Merge Queue" path="/merge-queue" icon="octicon:git-merge-queue-16">
      Parallel testing, batching, and priority queues.
    </Docset>
    <Docset title="CI Insights" path="/ci-insights" icon="mdi:lightbulb-outline">
      Flaky test detection, auto-retry, and quarantine.
    </Docset>
    <Docset title="Monorepo CI" path="/monorepo-ci" icon="tabler:topology-star-ring-3">
      Scope-aware CI that runs only what matters.
    </Docset>
    <Docset title="Workflow Automation" path="/workflow" icon="bi:robot">
      Rule engine and actions to automate PR workflows.
    </Docset>
    <Docset title="Merge Protections" path="/merge-protections" icon="fa6-solid:user-shield">
      Advanced guardrails before code lands.
    </Docset>
    <Docset title="Stacks" path="/stacks" icon="bi:stack">
      Stacked PR workflow for incremental changes.
    </Docset>
    <Docset title="Support" path="/support" icon="fa-solid:life-ring">
      Contact channels and response goals.
    </Docset>
  </DocsetGrid>

  {/* -------------- COMMUNITY -------------- */}

  <section class="community">
    <h2 class="home-title">Community</h2>
    <p>Share feedback, ask questions, and see what other teams build with Mergify.</p>
    <div class="community-buttons">
      <CommunityButton href="https://github.com/Mergifyio/mergify/discussions" icon="simple-icons:github" />
      <CommunityButton href="https://www.youtube.com/@mergifyio" icon="simple-icons:youtube" />
      <CommunityButton href="https://slack.mergify.com" icon="simple-icons:slack" />
      <CommunityButton href="https://x.com/mergifyio" icon="simple-icons:x" />
      <CommunityButton href="https://www.linkedin.com/company/mergify/" icon="simple-icons:linkedin" />
    </div>
  </section>
</div>