{"repo":"Redocly/create-openapi-repo","free":true,"listed":false,"github":"https://github.com/Redocly/create-openapi-repo","clone":"git clone https://github.com/Redocly/create-openapi-repo.git","description":"🤖 Generator for GH repo to help you manage the OpenAPI definition lifecycle","language":"JavaScript","stars":695,"topics":["swagger","openapi","api-documentation","gh-pages","openapi3","openapi31"],"license":"MIT","category":"api-integrations-sdks","readme_excerpt":"create-openapi-repo A tool for generating multi-file OpenAPI definitions. [![NPM version][npm-image]][npm-url] [![Dependency Status][daviddm-image]][daviddm-url] Need to write or contribute to an OpenAPI definition? create-openapi-repo can help with that! Features - OpenAPI 3.0 support - Split an existing OpenAPI definition into multiple files - Bundle a multi-file definition into a single file - Validate your OpenAPI definition using our free openapi-cli tool - Automate deployment of your API reference docs using CI/CD workflows - Maintain code samples as separate files - Live editing in your editor of choice :heart eyes: Examples - Rebilly - Thingful Prerequisites Before you begin, make sure you have the following prerequisites: - Node.js - Github repository (new OpenAPI definitions only) Installation 1. Navigate to the location where you want to create the repository. 2. Run one of the following commands: - Install create-openapi-repo globally: - Install create-openapi-repo using npx : 3. Follow the interactive prompts to complete the installation. Upgrading from a prior version To upgrade from a prior version of create-openapi-repo , run the following command in the root folder of your repository: Note: Plugins aren't included in the migration. You'll need to manually add them to the transformers folder. Usage create-openapi-repo provides interactive prompts to help guide you through the installation process. Two basic workflows are supported: Split an existing OpenAPI de","default_branch":null,"files":null,"tree":[],"storefront":"/r/Redocly","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/Redocly/create-openapi-repo/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}