Post

YAMLess - Swagger UI, but you also edit the spec

Edit OpenAPI in Swagger UI, then save and load specs via GitHub Gists.

YAMLess - Swagger UI, but you also edit the spec

Swagger UI is great for exploring APIs, but the spec is read-only. To change paths, schemas, or parameters you jump to another editor and keep two views in sync.

YAMLess is a fork of Swagger UI. It keeps the same layout and try-it-out flow, but adds inline edits that update the OpenAPI document in place.

Save with GitHub

Sign in with GitHub to store your spec in a Gist and load it back later.

Walkthrough

Starting from a clean demo:

YAMLess on the Petstore demo Petstore demo with the usual Swagger UI layout.

Add a schema from the UI:

Add a schema

Add a tag:

Add a tag

Add an endpoint:

Add an endpoint

Edit an existing endpoint:

Edit an endpoint

Add a parameter:

Add a parameter

Edit the request body:

Edit the request body

Add a response body:

Add a response body

Wire in a new schema:

Add a schema reference

Edit schema fields:

Edit schema properties

Why I built it

I wanted something lightweight for quick API design sessions. If that sounds useful, try the demo and open an issue or PR on the repo.

This post is licensed under CC BY 4.0 by the author.

Trending Tags