Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@scalar/types

scalar482.3kMIT0.0.27TypeScript support: included

Types to work with Scalar packages

typescript, types, scalar, references

readme

CI Contributors GitHub License Discord Scalar App

Scalar

<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"> Scalar API client </picture> <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"> Scalar API Reference </picture>

An offline first API Client built for OpenAPI

└ Minimal, powerful & open-source
└ Integrates with dozens of API Frameworks (Elysia, Hono, FastAPI, etc)
└ Syncs directly with your server frameworks with our Watch Mode
└ First class OpenAPI (formerly Swagger) support
└ Environment variables and dynamic parameters
└ Save and organize requests into collections
Download (Windows, MacOS, Linux)
Try Online Demo

Interactive API Reference from OpenAPI/Swagger

└ Uses OpenAPI/Swagger documents
└ Request examples for many favorite languages and frameworks
└ Comes with an integrated API playground
└ Integrates with your favorite framework
└ Doesn't look like 2011
Try Demo

Trusted by:


Quickstart

You’re just one HTML file away from having an awesome 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>
    <!-- Need a Custom Header? Check out this example: https://codepen.io/scalarorg/pen/VwOXqam -->
    <!-- Note: We’re using our public proxy to avoid CORS issues. You can remove the `data-proxy-url` attribute if you don’t need it. -->
    <script
      id="api-reference"
      data-url="https://cdn.jsdelivr.net/npm/@scalar/galaxy/dist/latest.yaml"
      data-proxy-url="https://proxy.scalar.com"></script>

    <script src="https://cdn.jsdelivr.net/npm/@scalar/api-reference"></script>
  </body>
</html>

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

Integrations

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 your API references (free)
  • Get SSL and a super cool *.apidocumentation.com subdomain (free)
  • Write free text documentation (paid)
  • Collaborate with your whole team (paid)
  • Use any domain (paid)

Ready? Create your account on scalar.com.


Projects

Project Description
Scalar API Client API client
Scalar CLI Command-line interface
Scalar Galaxy OpenAPI Example
Scalar Play Button Quick API Client Embed
Scalar Mock Server OpenAPI Mock Server
Scalar Void Server HTTP Request Mirror
Scalar Open API Parser OpenAPI SDK
Scalar Sandbox Online OpenAPI Editor

Documentation

Topic Description
Themes Themes, layouts & styling
Configuration The universal configuration object
OpenAPI OpenAPI and our extensions to it
Markdown Markdown syntax

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 (November 2024)



Top Contributors (All Time)

hanspagel
hanspagel
amritk
amritk
xC0dex
xC0dex
tmastrom
tmastrom
marclave
marclave
antlio
antlio
hwkr
hwkr
cameronrohani
cameronrohani
geoffgscott
geoffgscott
inyourtime
inyourtime
Amorim33
Amorim33
Mason-Little
Mason-Little
adjsky
adjsky
mcollina
mcollina
RemcoGoy
RemcoGoy
Mohib834
Mohib834
lc-soft
lc-soft
fuma-nama
fuma-nama
Edgaraszs
Edgaraszs
ATREAY
ATREAY
soulchild
soulchild
yshrsmz
yshrsmz
mpminardi
mpminardi
hex0id
hex0id
x-delfino
x-delfino
ykdojo
ykdojo
timheuer
timheuer
federicobond
federicobond
mouhannad-sh
mouhannad-sh
mason-at-pieces
mason-at-pieces
gsmcdonald
gsmcdonald
Huliiiiii
Huliiiiii
dotfortun
dotfortun
SebastianBienert
SebastianBienert
realsama
realsama
captainsafia
captainsafia
STP5940
STP5940
rmp135
rmp135
rpmccarter
rpmccarter
hrynevychroman
hrynevychroman
rbange
rbange
rickihastings
rickihastings
MaxBreida
MaxBreida
MarioGK
MarioGK
luc122c
luc122c
ShadiestGoat
ShadiestGoat
sanscontext
sanscontext
tsiwek-piwik
tsiwek-piwik
dunklesToast
dunklesToast
kwaichanz
kwaichanz
ga1az
ga1az
FotieMConstant
FotieMConstant
danwithabox
danwithabox
WilliamBonvini
WilliamBonvini
bsdayo
bsdayo
Chinlinlee
Chinlinlee
ruizhii
ruizhii
wilcoschoneveld
wilcoschoneveld
Mai0313
Mai0313
Courtcircuits
Courtcircuits
thibaultleouay
thibaultleouay
sinh117801
sinh117801
soGit
soGit
elliotnash
elliotnash
diegolopes
diegolopes
lundibundi
lundibundi
darekaze
darekaze
danp
danp
danjohnson95
danjohnson95
chrislearn
chrislearn
chadwhitacre
chadwhitacre
carstenlebek
carstenlebek
brunogrcsada
brunogrcsada
bdpiprava
bdpiprava
zsilbi
zsilbi
arthurfiorette
arthurfiorette
arashsheyda
arashsheyda
sigpwned
sigpwned
alewin
alewin
slash686
slash686
abdulamite
abdulamite
kyllian
kyllian
KiARC
KiARC
IHIutch
IHIutch
jonataw
jonataw
Jefwillems
Jefwillems
TheVaan
TheVaan
JacobCoffee
JacobCoffee
kevinand11
kevinand11
eltociear
eltociear
IceyWu
IceyWu
ivanagas
ivanagas
CJHwong
CJHwong
HelgeSverre
HelgeSverre
Hamidrzash
Hamidrzash
GreyXor
GreyXor
Fdawgs
Fdawgs
facus26
facus26
emmanuel-ferdman
emmanuel-ferdman

changelog

@scalar/types

0.0.27

Patch Changes

  • b552db5: feat: add url customization functions for references

0.0.26

Patch Changes

  • 60cd6f1: feat: render the operation description from the new store
  • 60cd6f1: chore: deprecated the TransformedOperation type
  • Updated dependencies [13333e6]

0.0.25

Patch Changes

  • c263aaf: chore: improve the comment for UnknownObject

0.0.24

Patch Changes

  • fbef0c3: chore: remove httpsnippet-lite

0.0.23

Patch Changes

  • c2f5f08: feat: adds hideClientButton option configuration

0.0.22

Patch Changes

  • baaad1c: refactor: deprecated the proxy configuration attribute, and use proxyUrl everywhere
  • c984ac8: feat: adds servers to information reference config

0.0.21

Patch Changes

  • 9d23f95: chore: deprecate Parameters, use Parameter instead

0.0.20

Patch Changes

  • f67c3bc: feat: add framework themes

0.0.19

Patch Changes

0.0.18

Patch Changes

  • fb798c8: chore: make OpenAPI document URLs the default, deprecated content

0.0.17

Patch Changes

0.0.16

Patch Changes

  • dbbe38f: feat: add framework identifier for debugging purposes

0.0.15

Patch Changes

0.0.14

Patch Changes

0.0.13

Patch Changes

  • 9dc2ab7: feat: new operationsSorter option

0.0.12

Patch Changes

  • 8f12149: chore: add point to declaration file

0.0.11

Patch Changes

  • f961940: feat: remove @scalar/themes from the dependencies of @scalar/types

0.0.10

Patch Changes

0.0.9

Patch Changes

0.0.8

Patch Changes

0.0.7

Patch Changes

  • a07cfc8: feat: allow to hide the Test Request button
  • 023ca15: feat: adds favicon configuration
  • 85872b6: feat: allow to hide search sidebar

0.0.6

Patch Changes

0.0.5

Patch Changes

0.0.4

Patch Changes

0.0.3

Patch Changes

0.0.2

Patch Changes

  • 910b1c2: Add build step for path resolution

0.0.1

Patch Changes