Scalar

Visit Website

Introduction

Scalar started as a modern, open-source alternative to Swagger UI and has grown into a platform built around a single OpenAPI document. The repository’s two best-known pieces are an interactive API reference generated from OpenAPI or Swagger files, with code examples for many languages and frameworks, and an offline-first API client built for OpenAPI.

The API reference is easy to adopt: all you need is a single HTML file that loads the ESM build from a CDN, with no build step, and points at your OpenAPI document. There is also an ever-growing list of framework integrations, and several frameworks have chosen Scalar as their default OpenAPI documentation UI. Frameworks mentioned in the README include Elysia, Hono and FastAPI.

The API client integrates with dozens of API frameworks and can sync with your server framework in watch mode, so requests stay up to date as your spec changes. It supports environment variables and dynamic parameters, and because it is offline-first, you can test APIs without a cloud account.

Scalar’s newest positioning is “infrastructure for APIs in the age of agents”: from an agent’s first read of your docs to its millionth production call, Scalar wants to be the layer in between, hosted, observed and kept in sync from one OpenAPI document. Agent-friendly touches already exist, such as a scalar-api-reference skill for coding agents (installed with npx skills add scalar/scalar --skill scalar-api-reference) and a ready-made prompt that tells an agent how to inspect your project’s framework and wire up the reference at /scalar.

Managed hosting is offered in free and paid tiers. The free tier lets you write API documentation, publish references and get a YOUR_NAME_HERE.apidocumentation.com subdomain with SSL.

For testing teams, Scalar helps at the contract level. A reference generated from the same OpenAPI document your contract tests use keeps docs, client and tests aligned. Pair Scalar’s client for exploratory requests with a contract testing tool such as Schemathesis or Dredd so that the spec, docs and implementation cannot drift apart unnoticed.

The source code is at scalar/scalar on GitHub under the MIT licence, with about 16,400 stars; the most recent commit was on 10 November 2026.

A practical rule is to generate the OpenAPI document from code, or validate code against it in CI, so the reference Scalar renders is always accurate. Docs that drift from the implementation are worse than no docs, because developers and agents trust them.

If you are evaluating Scalar against Swagger UI or Redoc-style tools, compare search, code samples and how well the client handles authentication flows your API uses.

Teams publishing APIs for AI agents should also consider how machine-readable the docs are. A complete, accurate OpenAPI document with good descriptions helps both human readers and agents choose the right endpoint and parameters.

Its offline client also suits regulated environments where sending requests through a cloud-synced tool is not allowed, because collections and environments can stay on the developer’s machine.

Features

1. Interactive API reference: Generated from OpenAPI/Swagger.
2. Code examples: Many languages and frameworks.
3. Single-file setup: CDN ESM build, no build step.
4. Framework integrations: Elysia, Hono, FastAPI and dozens more.
5. Offline-first client: Test APIs without an account.
6. Watch mode: Syncs with your server framework.
7. Environments: Variables and dynamic parameters.
8. Agent skill: Coding-agent setup guidance.
9. Managed hosting: Free subdomain and SSL.

Pros

1. Huge adoption: Default docs UI in several frameworks.
2. Modern UX: A friendlier Swagger UI alternative.
3. Free to use: Open source under the MIT licence, so the core tool costs nothing to use.
4. Actively maintained: The repository had commits as recent as 10 November 2026.
5. Community: About 16,400 GitHub stars.

Cons

1. OpenAPI-centric: Less useful without a spec.
2. Platform still evolving: Agent-era features are new.
3. Paid tiers for teams: Advanced hosting is paid.

Usage and Links (Example)

<!doctype html>
<html>
  <body>
    <div id="app"></div>
    <script type="module">
      import { createApiReference } from 'https://cdn.jsdelivr.net/npm/@scalar/api-reference/esm.js'
      createApiReference('#app', { url: '/openapi.json' })
    </script>
  </body>
</html>

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

Resources:

• Scalar website
• GitHub repository

Pricing

Scalar’s open-source packages are free (MIT). Managed hosting has a free tier (publish references on an apidocumentation.com subdomain with SSL) and paid plans for teams.

Recommended for?

1. API teams with an OpenAPI spec wanting great docs fast.
2. Developers who want a free, offline API client.
3. Platform teams preparing APIs for AI agents.

Conclusion

Scalar is the most popular modern OpenAPI reference and a capable API client.

Keep its spec in the same repository as your contract tests.

On CheckOps, Scalar is filed under the API & contract testing and Integration testing stages. Related tools listed here include SwaggerUI, Postman, Insomnia, Bruno, Hoppscotch and Stoplight Prism. Which one fits best depends mostly on your stack, your team’s size and skills, and whether you prefer to run tools yourself or pay for a managed service. This page reflects the official website, documentation and repository as they stood on 11 November 2026.