# swagger-api/swagger-ui

Swagger UI is a collection of HTML, JavaScript, and CSS assets that dynamically generate beautiful documentation from a Swagger-compliant API.

Repository: https://github.com/swagger-api/swagger-ui
Canonical: https://ross.abutalabs.com/products/swagger-ui
Homepage: https://swagger.io
Language: JavaScript
License: Apache-2.0
License Family: permissive
Topics: swagger, swagger-ui, swagger-api, rest, rest-api, openapi-specification, oas, openapi, openapi3, hacktoberfest, openapi31, open-source, swagger-oss, openapi32, swagger-client
Last push: 2026-08-26T23:02:48+00:00

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 98, longevity 100
- inputs: {"age_days": 5528, "days_push": 7, "days_rel": 15, "gap_med": 6, "n_releases_24m": 60}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 28990, forks 9259 (observed 2026-08-28T04:11:53.000078+00:00)

## What it is
Swagger UI is a collection of HTML, JavaScript, and CSS assets that dynamically generate interactive API documentation from an OpenAPI (Swagger) specification. It lets users visualize and try out API endpoints directly in the browser without any implementation logic in place.

## Use cases
- generate interactive documentation from an openapi spec
- let users try out rest api endpoints in the browser
- embed api docs in a react application
- serve api documentation from a docker container
- explore and test an api without writing client code
- publish developer-facing docs for a rest api

## When to choose
- you have an OpenAPI/Swagger spec and want interactive, auto-generated docs
- you want consumers to explore and execute API calls from the browser
- you need embeddable docs via npm, a React component, or a dependency-free dist bundle

## When to avoid
- your API is not described by an OpenAPI/Swagger specification
- you need a full documentation portal with search, branding, and multi-API catalogs
- you need to generate client SDKs or server stubs rather than documentation

## Facets
- artifact type: library
- maturity: stable
- function: api-documentation, documentation, http-client, ui-components
- domain: apis, web-development, developer-tools, documentation
- platform: browser, self-hosted
- tags: openapi, swagger, interactive-docs, rest-api, api-explorer, react-component, web-server, nodejs, docker

## Member repositories
- swagger-api/swagger-ui (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:53.000078+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-29T16:53:15.869739+00:00, confidence not recorded.
  - readme: https://github.com/swagger-api/swagger-ui (fetched 2026-08-28T04:11:53.000078+00:00, sha 9ac8747ac8f8)
  - homepage: https://swagger.io (fetched 2026-08-29T07:50:41.684572+00:00, sha 8e763c50e95b)
  - site_page: https://swagger.io/docs (fetched 2026-08-29T07:50:41.689322+00:00, sha bc9e768d7742)
  - site_page: https://swagger.io/product/portal (fetched 2026-08-29T07:50:41.687434+00:00, sha a39114d3b402)
- Data as of 2026-08-30T08:39:29.467469+00:00.