# scottie1984/swagger-ui-express

Adds middleware to your express app to serve the Swagger UI bound to your Swagger document. This acts as living documentation for your API hosted from within your app.

Repository: https://github.com/scottie1984/swagger-ui-express
Canonical: https://ross.abutalabs.com/products/swagger-ui-express
Language: HTML
License: MIT
License Family: permissive
Last push: 2025-01-25T15:56:04+00:00

## Health v2 (maintenance only)
Score: 24/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 3, release rhythm 8, longevity 100
- inputs: {"age_days": 3683, "days_push": 585, "days_rel": 585, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1497, forks 236 (observed 2026-08-28T04:04:53.866629+00:00)

## What it is
An Express middleware module that serves Swagger UI from a swagger.json (or generated spec) file, exposing interactive API documentation at a route in your app. It acts as living documentation hosted directly from your API server.

## Use cases
- serve swagger ui from an express app
- host interactive api documentation for my node.js api
- add openapi docs endpoint to express
- living documentation for a rest api
- render swagger.json in the browser
- integrate swagger docs with express router

## When to choose
- you have an Express app and a Swagger/OpenAPI document you want to expose as browsable docs
- you want documentation served from the same server as your API
- you use swagger-jsdoc and need a UI to render the generated spec

## When to avoid
- your API is not built on Express or Node.js
- you only need static documentation files rather than a served UI
- you need spec generation itself rather than UI serving

## Facets
- artifact type: library
- maturity: active
- function: api-documentation, middleware, documentation
- domain: web-development, backend, apis, documentation
- platform: -
- tags: swagger, openapi, express, api-docs, swagger-ui, nodejs, web-server

## Member repositories
- scottie1984/swagger-ui-express (main) score 24

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:53.866629+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:10.580244+00:00, confidence not recorded.
  - readme: https://github.com/scottie1984/swagger-ui-express (fetched 2026-08-28T04:04:53.866629+00:00, sha 8989234e1db6)
- Data as of 2026-08-30T08:39:29.467469+00:00.
