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

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

  <section class="home-hero">
    <div class="home-hero-inner">
      <div class="home-hero-copy">
        <div class="text-eyebrow home-hero-eyebrow">Mergify Documentation</div>
        <h1 class="heading-hero home-hero-title">
          Stop breaking <span class="home-hero-accent">main</span>.
        </h1>
        <p class="text-subtitle home-hero-subtitle">
          Mergify eliminates broken builds, tames flaky tests, and cuts CI waste — so your team
          ships with confidence.
        </p>
        <div class="home-hero-cta">
          <Button variant="primary" href="#products" target="_self">Browse all products</Button>
        </div>
      </div>
      <div class="home-hero-visual">
        <Image
          src={mergeQueueHero}
          alt="Merge Queue dashboard showing a queue of pull requests being processed in parallel"
          loading="eager"
          fetchpriority="high"
          densities={[1, 2]}
          class="home-hero-screenshot"
        />
      </div>
    </div>
  </section>

  {/* ---------------- METRICS STRIP ---------------- */}

  <section class="home-metrics-strip" aria-label="Mergify impact at a glance">
    <div class="home-metric">
      <div class="home-metric-value">3-5×</div>
      <div class="home-metric-label">faster merge throughput</div>
    </div>
    <div class="home-metric">
      <div class="home-metric-value">60-90%</div>
      <div class="home-metric-label">CI cost reduction</div>
    </div>
    <div class="home-metric">
      <div class="home-metric-value">0</div>
      <div class="home-metric-label">broken builds</div>
    </div>
  </section>

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

  <section class="home-problems">
    <h2>What problem are you solving?</h2>
    <div class="home-problems-grid">
      <a href="/merge-queue" class="home-problem-card" data-product="merge-queue">
        <div class="home-problem-title">Broken main, slow merges</div>
        <div class="home-problem-desc">
          PRs pass CI individually but fail when merged.
        </div>
        <div class="home-problem-cta">Merge Queue →</div>
      </a>
      <a href="/ci-insights" class="home-problem-card" data-product="ci-insights">
        <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">CI Insights →</div>
      </a>
      <a href="/test-insights" class="home-problem-card" data-product="test-insights">
        <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.
        </div>
        <div class="home-problem-cta">Test Insights →</div>
      </a>
    </div>
  </section>

  {/* -------------- PRODUCTS -------------- */}

  <section id="products" class="home-products">
    <h2>Products</h2>
    <div class="home-products-grid">
    <DocsetGrid>
      <Docset title="Merge Queue" path="/merge-queue" icon="mergify:merge-queue">
        Parallel testing, batching, and priority queues.
      </Docset>
      <Docset title="CI Insights" path="/ci-insights" icon="mergify:ci-insights">
        Scope-aware CI that runs only what matters.
      </Docset>
      <Docset title="Test Insights" path="/test-insights" icon="mergify:test-insights">
        Flaky test detection, auto-retry, and quarantine.
      </Docset>
      <Docset title="Merge Protections" path="/merge-protections" icon="mergify:merge-protections">
        Advanced guardrails before code lands.
      </Docset>
      <Docset title="Stacks" path="/stacks" icon="mergify:stacks">
        Stacked PR workflow for incremental changes.
      </Docset>
      <Docset title="Workflow Automation" path="/workflow" icon="lucide:bot">
        Rule engine and actions to automate PR workflows.
      </Docset>
    </DocsetGrid>
    </div>
    <p class="home-reference-footer">
      Reference:{' '}
      <a href="/configuration/file-format">Configuration</a> ·{' '}
      <a href="/configuration/conditions">Conditions</a> ·{' '}
      <a href="/commands">Commands</a> ·{' '}
      <a href="/api">API</a> ·{' '}
      <a href="/integrations">Integrations</a>
    </p>
  </section>

  {/* -------------- DISCOVERY CALLOUT -------------- */}

  <aside class="home-discovery">
    <div class="home-discovery-text">
      <div class="home-discovery-title">Not sure where to start?</div>
      <div class="home-discovery-desc">
        A 30-minute call with our team. We'll map your CI bottlenecks to the right setup.
      </div>
    </div>
    <Button variant="primary" href="https://mergify.com/discovery">
      Book a discovery call
    </Button>
  </aside>

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

  <section class="community">
    <h2>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>