scalar
Scalar
<picture>
<source media="(prefers-color-scheme: light)" srcset="https://github.com/user-attachments/assets/9b639f2d-0204-4b15-b918-158072a9afa5">
<source media="(prefers-color-scheme: dark)" srcset="https://github.com/user-attachments/assets/be723d07-ec9c-4edb-b657-05a8bc05c7d6">
</picture>
<picture>
<source media="(prefers-color-scheme: light)" srcset="https://github.com/user-attachments/assets/b391b82f-d993-4e97-8a17-1c3c7ccbb19b">
<source media="(prefers-color-scheme: dark)" srcset="https://github.com/user-attachments/assets/579d0853-b2a5-4ea8-b2bd-a98753faeaf3">
</picture>
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)
<picture>
<source media="(prefers-color-scheme: light)" srcset="https://github.com/user-attachments/assets/73dcef95-fc4f-4111-bb09-f3ce37453a81#gh-light-mode-only">
<source media="(prefers-color-scheme: dark)" srcset="https://github.com/user-attachments/assets/c792c977-8551-432c-9417-3ea05e408151#gh-dark-mode-only">
</picture>
<picture>
<source media="(prefers-color-scheme: light)" srcset="https://github.com/user-attachments/assets/1da6b904-34be-4760-b535-0dd2160e6d12#gh-light-mode-only">
<source media="(prefers-color-scheme: dark)" srcset="https://github.com/user-attachments/assets/54a9ea69-c50a-4f49-8c3e-ddd6f8fbe1f3#gh-dark-mode-only">
</picture>
Quickstart
All you need is a single HTML file to create an amazing API reference:
<!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>
<!-- Load the Script -->
<script src="https://cdn.jsdelivr.net/npm/@scalar/api-reference"></script>
<!-- Initialize the Scalar API Reference -->
<script>
Scalar.createApiReference('#app', {
// The URL of the OpenAPI/Swagger 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:
Integrations
- HTML/JS API (works everywhere)
- .NET ASP.NET Core
- .NET Aspire
- AdonisJS
- Astro
- Django Ninja
- Django
- Docker
- Docusaurus
- Elixir
- Express
- FastAPI
- Fastify
- Flask
- Go
- Hapi
- Hono
- Laravel Scribe
- Laravel
- Micronaut
- NestJS
- Next.js
- Nuxt
- Python
- React
- Ruby on Rails
- Rust
- Spring Boot
- SvelteKit
- Ts.ED
- Vue.js
Built-in Support
The following frameworks have chosen Scalar API Reference as their default OpenAPI documentation UI, recognizing its developer-friendly features and modern design:
Managed Hosting
We're offering a free and paid managed hosting on the edge, too:
- Write your API documentation and publish API references (free)
YOUR_NAME_HERE.apidocumentation.comsubdomain and SSL (free)- GitHub Sync
- Write free-form documentation
- Collaborate with your team
- Use any domain
Ready? Create your Scalar Account
Documentation
| Topic | Description |
|---|---|
| Configuration | The universal configuration object |
| Themes | Predefined themes, layouts & styling |
| OpenAPI | OpenAPI specification extensions |
| Markdown | Supported Markdown syntax |
| Plugins | Extend the functionality |
Projects
| Project | Description |
|---|---|
| Scalar API Reference | Self-hosted API Reference |
| Scalar API Client | Postman alternative |
| Scalar Registry | Manage OpenAPI documents |
| Scalar Docs | Hosted documentation |
| Scalar Docs Starter | Starter template for Scalar Docs |
| Scalar SDKs | SDK generation |
| Scalar CLI | Command-line interface |
| Scalar Mock Server | Mock APIs from OpenAPI documents |
| Scalar Galaxy | Our OpenAPI Example |
| Scalar Editor | OpenAPI Online Editor |
| Scalar OpenAPI Parser | Parse OpenAPI documents |
| Scalar OpenAPI Upgrader | Upgrade OpenAPI documents |
| Scalar Void Server | HTTP Request Mirror |
Community
We are API nerds. You too? Let's chat on Discord: https://discord.gg/scalar
Contributions
Contributions are welcome! Read the CONTRIBUTING guide.
Top 10 Contributors (April 2025)
Top Contributors (All Time)
