Is there an open-source alternative to SwaggerHub for Rails?

Yes — Rswag. It mounts into an application you already run, so there is no second deployment and no second database.

How do I replace SwaggerHub in a Rails app?

Add rswag to your Gemfile, mount it in config/routes.rb at /api-docs, and run its migrations. The whole integration is two lines and a migration.

How much does replacing SwaggerHub save?

SwaggerHub is priced from $25/mo. The engines here are open source, so the cost becomes the time to mount one and the resources it uses inside your existing application.

Replace SwaggerHub

Write an OpenAPI spec, host the rendered docs, keep them versioned.

SwaggerHub website From $25/mo Developer experience

Why teams move off SwaggerHub

Hosting an OpenAPI document — which your test suite can generate — for $25 a month upwards.

What you give up

Collaborative spec design and mock servers.

This directory says so when an engine only covers part of the job. A replacement that needs a caveat is still worth knowing about — it just should not surprise you in week three.

Drop-in replacement

SwaggerHub → rswag

# Gemfile
gem "rswag"

# config/routes.rb
mount Rswag::Api::Engine, at: "/api-docs"

Read about Rswag →

1 Rails engine that replaces SwaggerHub

Rswag
Drop-in replacement Developer experience

Authoring, hosting and browsing an OpenAPI spec — with the spec generated from tests that must pass.

SwaggerHub → rswag

No ratings yet →

Questions

Is there an open-source alternative to SwaggerHub for Rails?: Yes — Rswag. It mounts into an application you already run, so there is no second deployment and no second database.
What do I give up by replacing SwaggerHub?: Collaborative spec design and mock servers.
How do I replace SwaggerHub in a Rails app?: Add rswag to your Gemfile, mount it in config/routes.rb at /api-docs, and run its migrations. The whole integration is two lines and a migration.
How much does replacing SwaggerHub save?: SwaggerHub is priced from $25/mo. The engines here are open source, so the cost becomes the time to mount one and the resources it uses inside your existing application.

Same category

While you are cancelling things