Behemoth YAML gets old pretty quick. An unbundled definition is far easier to edit and check for duplicates. Our Redocly CLI lets you quickly validate and lint a multi-file definition before bundling it into one file for distribution.
Solve errors crazy-fast, with complete visibility and a complete set of built-in options supporting the full OpenAPI spec up to 3.1. Find errors anywhere:
Preview your entire reference docs locally without having to bundle your definition, whether you’re using Redocly or our open-source version Redoc.
Decorators are a Redocly-exclusive customization layer you can use to effectively build different versions of the same definition. They modify content during the bundle process, so you can e.g. add code samples, remove schema or change path structure after validation is complete.Read the Docs →
diff’ with decorators instead of manual work.
Write, validate, and maintain your OpenAPI documents with a single VS Code extension. Get warnings about errors in OpenAPI definitions and quickly access referenced schemas and the files that contain them.
Our CLI already powers Redocly Workflows under the hood. Enjoy the same collab power with your definition files and configuration neatly organized in Git. Starting from scratch? Use our companion repository template to get up to speed with the Way of the Multi-File API.Check out the GitHub repo