npm install
npm start
The start command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
The documentation website is hosted by AWS Amplify. All changes merged to the main branch are automatically deployed to docs.epilot.io
When documenting your APIs, it's possible to perform changes and eval how they look within the docs portal while running locally.
For that, all you need to do is follow the instructions below:
- Point your API spec on the file
docusaurus.config.jsto your localhost:http://localhost:3001/openapi.json npm startto run the docs portal locallynpm run swagger-ui:watchto serve your api docs locally on your API project- Finally to bypass CORS you will want to get this Chrome extension
When you are done, just deploy your openapi.yml as you normally would. And don't forget to update your client sdk here.