feat: add production adopter case studies

[aaguiarz]

Description

Adds an Adopters section to the documentation with eight production case studies based on CNCF TOC adopter interviews: Agicap, Docker, Grafana Labs, Read AI, Headspace, Zuplo, OpenLane, and Vitrolife Group.

The sidebar gains a new top-level Adopters category linking to the overview and all eight individual pages.

What problem is being solved?

How is it being solved?

What changes are made to solve it?

References

Review Checklist

• I have clicked on "allow edits by maintainers".
• I have added documentation for new/changed functionality in this PR or in a PR to openfga.dev [Provide a link to any relevant PRs in the references section above]
• The correct base branch is being used, if not main
• I have added tests to validate that the change in functionality is working as expected

Summary by CodeRabbit

• Documentation
  • Added comprehensive adopter case studies featuring production implementations from eight leading companies: Agicap, Docker, Grafana Labs, Headspace, OpenLane, Read AI, Vitrolife Group, and Zuplo. Each case study details their authorization architecture, outcomes, and deployment scale.
  • Added Adopters section to documentation navigation providing an overview and links to individual company case studies.

[coderabbitai]

Important

Review skipped

Auto incremental reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 05a1eccc-eeaf-49bd-a048-c5e5a9145d17

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

Walkthrough

This PR adds a new Adopters section to the OpenFGA documentation, featuring an overview page, sidebar navigation configuration, and eight detailed case study pages from production deployments at Agicap, Docker, Grafana Labs, Headspace, OpenLane, Read AI, Vitrolife, and Zuplo.

Changes

Adopters Section

Layer / File(s)	Summary
Adopters Overview and Sidebar Navigation docs/content/adopters/overview.mdx, docs/sidebars.js	Overview page introduces OpenFGA's production adoption landscape with a featured adopters table and shared themes. Sidebar configuration creates the Adopters category, linking to the overview and nested case-study items.
Adopter Case Studies docs/content/adopters/agicap.mdx, docs/content/adopters/docker.mdx, docs/content/adopters/grafana.mdx, docs/content/adopters/headspace.mdx, docs/content/adopters/openlane.mdx, docs/content/adopters/read-ai.mdx, docs/content/adopters/vitrolife.mdx, docs/content/adopters/zuplo.mdx	Eight independent case studies follow a consistent structure: "At a glance" metrics, adoption rationale, architecture patterns, outcomes, and source citations. Each highlights distinct use cases: ReBAC with secure facades, parallel migrations, multi-environment scale, BatchCheck optimization, GraphQL integration, high-scale metrics, hybrid IAM synchronization, and edge authorization.

---

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

---

Possibly related PRs

• openfga/openfga.dev#1271: Modifies docs/sidebars.js to add new doc categories (Industries, Use Cases, Learn), so it touches the same sidebar navigation configuration as this PR.

---

Suggested reviewers

• dyeam0
• rhamzeh
• tylernix

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'feat: add production adopter case studies' directly and clearly summarizes the main change: adding new documentation pages for production adopter case studies with eight company case studies.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/adopters-2

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[github-actions]

PR Preview Action v1.8.1
🚀 View preview at https://openfga.github.io/openfga.dev/pr-preview/pr-1280/
Built to branch gh-pages at 2026-06-11 05:09 UTC. Preview will be ready when the GitHub Pages deployment is complete.

[Copilot]

Pull request overview

This PR introduces a new Adopters section to the OpenFGA documentation, publishing an overview page plus eight production case studies and exposing them via a new top-level sidebar category.

Changes:

• Adds a new top-level Adopters sidebar category that links to an overview and eight adopter pages.
• Adds an Adopters overview page with a featured case-studies table and links to the broader adopter list.
• Adds eight new case study pages (Agicap, Docker, Grafana Labs, Read AI, Headspace, Zuplo, OpenLane, Vitrolife Group).

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
docs/sidebars.js	Adds a new top-level “Adopters” category and wires in all adopter docs.
docs/content/adopters/overview.mdx	Introduces the adopters landing page and a featured case-studies table.
docs/content/adopters/agicap.mdx	Adds the Agicap production case study page.
docs/content/adopters/docker.mdx	Adds the Docker production case study page.
docs/content/adopters/grafana.mdx	Adds the Grafana Labs production case study page.
docs/content/adopters/read-ai.mdx	Adds the Read AI production case study page.
docs/content/adopters/headspace.mdx	Adds the Headspace production case study page.
docs/content/adopters/zuplo.mdx	Adds the Zuplo production case study page.
docs/content/adopters/openlane.mdx	Adds the OpenLane production case study page.
docs/content/adopters/vitrolife.mdx	Adds the Vitrolife Group production case study page.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.