Scalar

Interactive API Reference from OpenAPI/Swagger

└ Renders OpenAPI/Swagger documents └ Comes with an API testing tool └ Doesn't look like 2011 └ Generates code examples for many languages & frameworks └ Integrates with your favorite framework └ Try Demo

An offline-first API Client built for OpenAPI

└ Free and open-source └ First-class OpenAPI/Swagger support └ Integrates with dozens of API Frameworks (Elysia, Hono, FastAPI, etc) └ Syncs with your favorite server framework (Watch Mode) └ Has environment variables, dynamic parameters and everything └ Try It in the Browser └ Download (Windows, MacOS, Linux)

Trusted by:

Quickstart

Set up with your coding agent

Install the scalar-api-reference skill to give your coding agent guidance for framework integration, configuration, and troubleshooting:

npx skills add scalar/scalar --skill scalar-api-reference

Copy this prompt into your coding agent from your project:

Set up Scalar API Reference in this project.

Inspect the project’s framework, package manager, routing, and existing
OpenAPI setup. Choose the appropriate framework integration from
https://scalar.com/products/api-references and install it using this
project’s conventions.

If no framework integration exists, render a route using the HTML/JS guide:
https://scalar.com/products/api-references/integrations/html-js
Also ask whether I want to request a framework integration here:
https://github.com/scalar/scalar/discussions/new?category=ideas

Serve the API reference at /scalar, or use an existing documentation route,
and connect it to the project’s OpenAPI document or generated endpoint.
If no OpenAPI document exists, ask me which source to use or whether
we need to add OpenAPI generation.

Use these guides for configuration and theming:
https://scalar.com/products/api-references/configuration
https://scalar.com/products/api-references/themes

Implement the setup, verify that the page loads and displays the API
documentation, and tell me how to run it locally and where to find it.

Set up with HTML

All you need is a single HTML file. Load the ESM build from our CDN, with no build step required:

<!doctype html>
<html>
  <head>
    <title>Scalar API Reference</title>
    <meta charset="utf-8" />
    <meta
      name="viewport"
      content="width=device-width, initial-scale=1" />
  </head>

  <body>
    <div id="app"></div>

    <script type="module">
      import { createApiReference } from 'https://cdn.jsdelivr.net/npm/@scalar/api-reference/esm.js'

      createApiReference('#app', {
        // The URL of the OpenAPI document
        url: 'https://registry.scalar.com/@scalar/apis/galaxy?format=json',
        // Avoid CORS issues
        proxyUrl: 'https://proxy.scalar.com',
      })
    </script>
  </body>
</html>

Need a Custom Header? Check out this example: https://codepen.io/scalarorg/pen/VwOXqam

And there's an ever-growing list of plugins and integrations:

This is the beginning of the README. Read the rest at the original. Read the full README ↗