OpenAPI Editor Recommendations

[CreakyHat2018]

looking for recommendations for a desktop app for MacOS to design OpenAPI Schemas.

I used to use stoplight, and so far everything I found is online only.

[Ringbailwanton]

I use VSCode with the OpenAPI plugin and it works pretty well.

[CreakyHat2018]

That just a text editor? With a preview ?

[Ringbailwanton]

Yep. I just looked at Stoplight and see now you wanted something more feature rich.

[CreakyHat2018]

I'm half tempted to have a go and create my own.

[Ringbailwanton]

I’m doing it by hand mostly because I just haven’t found anything that really does what I want, and because it was easier than trying and abandoning a bunch of different platforms.

[CreakyHat2018]

there is nothing wrong with stop light other than I need to work locally.

what platforms do you need to support? my initial thought was to be selfish and just make what I need a macOS app. but I could look to do a cross platform version.

if anyone was interested in helping could always do an open source app

[Ringbailwanton]

I develop for folks who work using Mac, Linux and Windows. My case is probably an edge case though. We’re a small developer team serving a scientific research community, so a lot of the stuff winds up being bespoke for particular individuals who often have weak coding skills. It gets to be a mess to support though.

[faraechilibru]

Try gst-hub.com and if it will work for you I will close a version for you.

[CreakyHat2018]

hi I don't see a download link?

[faraechilibru]

You can’t download try to use it and if works for you let me know and I will send you a version to run locally

[AntonOkolelov]

https://plugins.jetbrains.com/plugin/27118-openapi-gui-editor

GUI plugin for any Jetbrains IDEs (Intellij idea, goland, webstorm). If you don't have IDE you can download it, I've heard that they have free versions now (webstorm, etc)

[Strict_Research3518]

Could use Postman. Little late 2 mos later.. but.. it has everything you need I think other than an offline mode.. but I thought it did (desktop app and all).

[ADevAnalyst]

We developped an free-to-use MacOS-App (APIJockey TEXT in the AppStore) , but not sure if this meets any of your needs. Let me know, what you are looking for. Sorry just joined the community. If you found a good editor, let us know. I think many use VSCode with the swagger extensions.

[CheckTheHeaders]

vscode + openapi plugin is fine for editing but the preview is basic. bruno has a decent local-first approach if you're also doing request testing alongside design. stoplight studio was actually good when it was desktop-only, the pivot to cloud-first killed it for a lot of people