openfga/openfga.dev

OpenFGA.dev is a documentation and website repository for OpenFGA, an open source fine-grained authorization solution based on Google's Zanzibar.

The repository serves as the central hub for OpenFGA's documentation, combining multiple content sources and publishing systems. Product documentation and API references are authored in Mintlify and published under the /docs path, while the homepage, project information, community pages, and blog are built with Docusaurus and hosted on GitHub Pages. The repository manages content migration from legacy Swagger-based API documentation to a new Mintlify-powered reference, maintaining backward compatibility through redirects. Large media assets use Git LFS to keep the repository manageable, while API documentation files use standard Git storage.

This repository is relevant for teams maintaining OpenFGA's public-facing information and for contributors looking to improve the authorization framework's documentation. It suits organizations building fine-grained authorization systems who want to understand OpenFGA's capabilities through its guides and API reference. The split deployment approach—with Mintlify handling product docs and Docusaurus managing the website—allows independent updates to different content types without coordinating a single build process.

The project maintains active quality checks that validate API schema consistency against upstream sources and enforce documentation standards before merge. Contributor tooling includes maintenance scripts for managing generated files, sitemaps, and LLM resources. The setup requires Node.js 22 alongside standard development tools, with clear separation between local preview environments for product documentation and the website.