# Mermade/openapi-gui

GUI / visual editor for creating and editing OpenAPI / Swagger definitions

Repository: https://github.com/Mermade/openapi-gui
Canonical: https://ross.abutalabs.com/products/openapi-gui
Homepage: https://mermade.github.io/openapi-gui/
Language: JavaScript
License: MIT
License Family: permissive
Topics: openapi, swagger, gui, editor, openapi3
Last push: 2024-06-16T11:31:54+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3598, "days_push": 808, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1494, forks 170 (observed 2026-08-28T04:04:52.788281+00:00)

## What it is
OpenAPI-GUI is a browser-based visual editor for creating and editing OpenAPI 3.0.x (and Swagger 2.0, auto-converted) JSON/YAML definitions. It runs entirely client-side with forms for editing paths, operations, and parameters, and can be self-hosted or served via an embedded Node.js web server.

## Use cases
- visually edit an OpenAPI 3.0 definition
- convert a Swagger 2.0 spec to OpenAPI 3.0
- bootstrap a new API spec without writing YAML by hand
- edit OpenAPI definitions in the browser
- import an existing OpenAPI definition from a URL and tweak it
- export edited API definitions as JSON or YAML

## When to choose
- you want a lightweight, no-install visual editor for simple OpenAPI definitions
- you need to convert Swagger 2.0 specs to OpenAPI 3.0 with a GUI
- you prefer a fully client-side tool with no backend or data leaving your browser

## When to avoid
- you need to manage large or complex OpenAPI definitions with advanced features
- you require multi-file or team-collaborative spec editing
- you need an actively developed tool with frequent updates

## Facets
- artifact type: application
- maturity: maintenance
- function: gui, editor, api-framework, http-server, cli
- domain: developer-tools, apis, web-development, documentation
- platform: browser, cli
- tags: openapi, swagger, visual-editor, api-design, client-side, vuejs, yaml, json, web-server, nodejs, docker

## Member repositories
- Mermade/openapi-gui (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:52.788281+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:33:20.279350+00:00, confidence not recorded.
  - readme: https://github.com/Mermade/openapi-gui (fetched 2026-08-28T04:04:52.788281+00:00, sha 7f12aa988e39)
  - homepage: https://mermade.github.io/openapi-gui/ (fetched 2026-08-29T11:39:05.042291+00:00, sha 1e2e38ce2cec)
  - registry_npm: https://registry.npmjs.org/openapi-gui (fetched 2026-08-29T11:39:05.051531+00:00, sha 2942f6902d00)
- Data as of 2026-08-30T08:39:29.467469+00:00.