npm

@scalar/api-reference

1.67.0scalar/scalar ↗

Generate beautiful API references from OpenAPI documents

Last release today
28 Aug 2026
Ships on a steady schedule
a new release about every 1 weeks
Most releases are documented
notes for 51 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
3 years old
705 releases · first in 2023

Release timeline

705 releases since 2023

2023202420252026

20232026

One column per quarter.

Releases

1.1.621 Nov 2023
Release notes
Patch Changes
- 36761e4: feat: make the available tabs configurable
- Updated dependencies [8e65ba9]
- Updated dependencies [36761e4]
  - @scalar/[email protected]
Open source →
1.1.521 Nov 2023
Release notes
Patch Changes
- b8dc5a5: fix: show path parameters in the parameter tables
- Updated dependencies [b6552df]
- Updated dependencies [b8dc5a5]
- Updated dependencies [04875a6]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
1.1.418 Nov 2023
Release notes
Patch Changes
- 752dcf3: feat: add support for models with top level anyOf, allOf, oneOf …
- Updated dependencies [a1575f2]
  - @scalar/[email protected]
Open source →
1.1.317 Nov 2023
Release notes
Patch Changes
- 75df2d2: feat: use bearer auth as the fallback for http auth
- c97e8e6: chore: add form tag to auth credentials
- 52c20e5: style: no text transform for model names
- b1fe23c: feat: add support for oneOf in response schemas feat: add support for allOf in response schemas
- 1208a7f: feat: add support for Swagger 2.0 host and schemes configuration
- Updated dependencies [3d6027c]
  - @scalar/[email protected]
Open source →
1.1.216 Nov 2023
Release notes
Patch Changes
- d062fd9: fix: deep linking in api references
Open source →
1.1.115 Nov 2023
Release notes
Patch Changes
- 5eb5dcf: refactor: bring back footer slot
Open source →
1.1.015 Nov 2023
Release notes
Minor Changes
- 77dce14: refactor(references)!: remove deprecated component props refactor(references): extract references code into base component feat(references): expose new props for references base component
Patch Changes
- d3205e5: feat: support request bodies with other mime types than JSON
- aa2a575: fix: cards overlapping header
- Updated dependencies [801f1b5]
  - @scalar/[email protected]
Open source →
1.0.612 Nov 2023
Release notes
Patch Changes
- 366b142: fix: ignore proxy when swagger spec is a path
- e1dc955: fix: add fallback to name for models if no xml attribute passed
- Updated dependencies [ceb7952]
  - @scalar/[email protected]
Open source →
1.0.510 Nov 2023
Release notes
Patch Changes
- ff81f70: refactor: move getting started example to GettingStarted component
- 5da1fc6: security: update axios from 1.5.0 to 1.6.1
- ff81f70: fix: don’t overwrite the CodeMirror content when collaborative editing is enabled
- Updated dependencies [ff81f70]
- Updated dependencies [5da1fc6]
- Updated dependencies [ff81f70]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
1.0.410 Nov 2023
Release notes
Patch Changes
- 7fb2302: feat: detect variables in URLs
- 54098d7: chore: better fallbacks for the operation.name
- dd06807: fix: optional chain for request bodies
- 551aa7d: fix: mobile sidebar always open by default
- 7fb2302: fix: show server variables for single URLs too
- 3eff44f: fix: show description component only when a description is specified
- f0dca6c: fix: add fallback if no summary or key is provided for examples
- Updated dependencies [54098d7]
- Updated dependencies [7fb2302]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
1.0.39 Nov 2023
Release notes
Patch Changes
- c92a3a3: fix: active state for the headings taken from the description
- 57cea1a: fix: don’t show a version badge if no version is defined
- dce99ae: fix: removed deleted icons from type definition
- 009a720: fix: add missing http logo
- 48118ba: feat: add updateContent event to the ApiReference component
- dab853a: chore: remove unused dependencies
- Updated dependencies [f4681d5]
- Updated dependencies [c92a3a3]
- Updated dependencies [48118ba]
- Updated dependencies [dab853a]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
1.0.26 Nov 2023
Release notes
Patch Changes
- a7e6c25: fix: externalize remark/rehype dependencies to fix SSG builds
- 4253b4a: fix: move footer below sidebar and editor when toggled
- Updated dependencies [a7e6c25]
  - @scalar/[email protected]
Open source →
1.0.12 Nov 2023
Release notes
Patch Changes
- 68edf8c: feat: add oas version and spec version to title
- e482ce0: fix: don’t overwrite the content if there is nothing configured
- 6af9829: refactor: add a ApiReferenceLayout component to offer slots for everything
- 6bdc65b: Exported ApiReferenceLayout as separate component
Open source →
1.0.02 Nov 2023
Release notes
Minor Changes
- 440815a: Add getting started to empty render area
Patch Changes
- 94d2fe4: fix: don’t show a security scheme select when there is only one
- b0835a2: users not using themed css fallbacks
- c470db5: make --theme priority over --default-theme in misc places
- 5243ae4: make search modal hotkey configurable
- 509db1e: refactor: move all api reference refs and watchers to hooks
- Updated dependencies [b0835a2]
- Updated dependencies [440815a]
- Updated dependencies [c470db5]
- Updated dependencies [da431d9]
- Updated dependencies [3c6f54f]
- Updated dependencies [509db1e]
- Updated dependencies [a4f1b08]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.8.1027 Oct 2023
Release notes
Patch Changes
- 8c15df74: remove extra borders + fix spacing when only 1 server child
Open source →
0.8.927 Oct 2023
Release notes
Patch Changes
- 9c7a5722: feat: make the server selectable feat: add inputs for server variables feat: pass configured server environment to example requests feat: pass configured server environment to the api client refactor: new helpers to generate the request data for the example request and the client
- a5df4a5b: fix: don’t show generated example responses if there’s an example
- Updated dependencies [9c7a5722]
  - @scalar/[email protected]
Open source →
0.8.826 Oct 2023
Release notes
Patch Changes
- 8e2e4e5a: fix markdown collisions + prefix the card name
- Updated dependencies [8e2e4e5a]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.8.726 Oct 2023
Release notes
Patch Changes
- db24e103: hotfix: import spec from url
- Updated dependencies [db24e103]
  - @scalar/[email protected]
Open source →
0.8.626 Oct 2023
Release notes
Patch Changes
- c75b13b1: hotfix: load the swagger editor even if it’s not used
Open source →
0.8.526 Oct 2023
Release notes
Patch Changes
- 2f0b2f01: fix: add deprecated footerBelowSidebar again (use configuration object instead)
- 2f0b2f01: feat: add download spec button
- 2f0b2f01: refactor: improve the data flow between the reference and the swagger editor
- 2f0b2f01: refactor: move json helpers to separate files
- Updated dependencies [2f0b2f01]
- Updated dependencies [2f0b2f01]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.8.425 Oct 2023
Release notes
Patch Changes
- Updated dependencies [a73ee9d8]
  - @scalar/[email protected]
Open source →
0.8.325 Oct 2023
Release notes
Patch Changes
- d5fccba9: add ai writer to swagger editor
- Updated dependencies [d5fccba9]
  - @scalar/[email protected]
Open source →
0.8.224 Oct 2023
Release notes
Patch Changes
- 3b042270: fix: active state for operations with multiple tags
- 4685f391: feat: introducing the new universal configuration object
- 8ac1ad69: chore: use different heading levels
- 28191084: feat: add security schemes to the reference
- e01134d4: style: use horizontal ellipsis to indicate strings in example responses
- Updated dependencies [64f8a018]
- Updated dependencies [ce04794a]
- Updated dependencies [7c3091c6]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.8.121 Oct 2023
Release notes
Patch Changes
- 7ed5c61a: fix: add target blank to markdown links
Open source →
0.8.020 Oct 2023
Release notes
Minor Changes
- 2eba4010: Refactor and simplify API references layout
Patch Changes
- 9d352b13: fix: make the sidebar work with tags without operations
- b71c4db7: feat: example objects in arrays for example responses
- 01109c6f: feat: use min value as the default for generated example responses
- Updated dependencies [df74d017]
- Updated dependencies [75d12f56]
- Updated dependencies [2eba4010]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.7.1119 Oct 2023
Release notes
Patch Changes
- 1f064818: added scrolling to the sidebar on highlight
- 1bd5fb80: feat: add syntax highlighting to the markdown renderer
Open source →
0.7.1018 Oct 2023
Release notes
Patch Changes
- c1cb507d: fix: search modal not scrolling to proper endpoints
- d1fcd043: ensure endpoint parent tag is open before trying to scroll
Open source →
0.7.918 Oct 2023
Release notes
Patch Changes
- 45ac0aaa: fix missing property description
Open source →
0.7.817 Oct 2023
Release notes
Patch Changes
- ab348cb5: Mobile improvements and layout fixes + consitency improvements
- 211ed1c7: polish up the models
- ca2689b6: feat: add example request body to example request generator
- ae247253: refactor: move generateRequest helpers to @scalar/api-reference
- 5896b08d: fix: add missing null check to jsonRequest requestBody
- Updated dependencies [ab348cb5]
- Updated dependencies [aa24dbe6]
- Updated dependencies [ae247253]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.7.717 Oct 2023
Release notes
Patch Changes
- 0495c0f9: feat: show models ("schemas") in the reference
- 528df9d1: feat: add support for oneOf, anyOf, allOf, not schema rules
- 8915c5cf: fix: add null check to tag operations in sidebar
- d755d34e: fix: default show endpoint when tags have one endpoint
- a161c962: fix: better deal with empty descriptions
- 7e7ea175: feat: use default value in schemas for example responses
Open source →
0.7.616 Oct 2023
Release notes
Patch Changes
- d87566fd: refactor: new section components, new sidebar
- 43628366: Fix overflow and scrolling issues for API client
- 6131fa72: chore: update README
- dd8df965: feat: add requestbody to api client if json schema available
- 52534317: Fix references not respecting height on mobile Safari
- Updated dependencies [db7f5f57]
- Updated dependencies [d87566fd]
- Updated dependencies [8be53df2]
- Updated dependencies [4eaee866]
- Updated dependencies [43628366]
- Updated dependencies [06b46553]
- Updated dependencies [dd8df965]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.7.513 Oct 2023
Release notes
Patch Changes
- fd875bc7: feat: show headings with a higher depth in the sidebar
- 28cce042: fix: externalize markdown plugins to not break SSG
- Updated dependencies [28cce042]
  - @scalar/[email protected]
Open source →
0.7.412 Oct 2023
Release notes
Patch Changes
- 51029c1d: add interactive params, headers and variables
- Updated dependencies [51029c1d]
  - @scalar/[email protected]
Open source →
0.7.312 Oct 2023
Release notes
Patch Changes
- 99936ab8: feat: add markdown headings to the sidebar
- 08e8f637: style: improve markdown code blocks
Open source →
0.7.211 Oct 2023
Release notes
Patch Changes
- fd6cf1bb: fix: too much recursion
- 357a174d: feat: fix import URL, use proxy to fetch files
- Updated dependencies [fd6cf1bb]
- Updated dependencies [357a174d]
- Updated dependencies [357a174d]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.7.111 Oct 2023
Release notes
Patch Changes
- 3c2bc6a9: style: update the search modal style
Open source →
0.7.011 Oct 2023
Release notes
Minor Changes
- fd38deb0: Add mobile menu and breadcrumbs
Patch Changes
- Updated dependencies [fd38deb0]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.6.2310 Oct 2023
Release notes
Patch Changes
- af4ec8d3: update discord links
- e643b56e: Fix incorrectly named css variables
- c6ac9ff4: fix search modal reactivity
- 749f2f3f: fix: initial swagger editor content is parsed
- 91b09499: Fix breadcrums throwing error for specs without operations in tags
- Updated dependencies [af4ec8d3]
- Updated dependencies [749f2f3f]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.6.2210 Oct 2023
Release notes
Patch Changes
- d4789991: fix: populate search fuse data immediately
Open source →
0.6.2110 Oct 2023
Release notes
Patch Changes
- ea110ca0: feat: export SearchModal component
- 1cbcabd7: lots of amazing fixes from when we missed last patch
- 9d22b4ca: fix: make the base urls reactive
- 437c4b01: amazing sprint fixes
- Updated dependencies [33604a1b]
- Updated dependencies [1cbcabd7]
- Updated dependencies [d7b12610]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.6.209 Oct 2023
Release notes
Patch Changes
- 37353dd1: feat: add data-proxy-url to the HTML API
- Updated dependencies [a7f776ba]
  - @scalar/[email protected]
Open source →
0.6.199 Oct 2023
Release notes
Patch Changes
- eb0c3201: Lot's of small things + bigger temp fix for the multi content cards
- Updated dependencies [eb0c3201]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.6.188 Oct 2023
Release notes
Patch Changes
- Updated dependencies [3805e649]
  - @scalar/[email protected]
Open source →
0.6.177 Oct 2023
Release notes
Patch Changes
- Updated dependencies [be239745]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.6.167 Oct 2023
Release notes
Patch Changes
- 0f87c35d: feat: add dark mode toggle 👀
- 3dd2574d: sidebar toggle not flex aligned + fix folder colors
- Updated dependencies [30aee7d1]
- Updated dependencies [99744358]
- Updated dependencies [24deb723]
- Updated dependencies [3dd2574d]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.6.155 Oct 2023
Release notes
Patch Changes
- 7b6c21e5: request history ui and some other small type changes
- Updated dependencies [7b6c21e5]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.6.144 Oct 2023
Release notes
Patch Changes
- 46142c0a: reference theme fixes
- Updated dependencies [46142c0a]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.6.134 Oct 2023
Release notes
Patch Changes
- 727d7f47: make swagger editor tab state controllable via prop
- Updated dependencies [727d7f47]
- Updated dependencies [727d7f47]
  - @scalar/[email protected]
Open source →
0.6.124 Oct 2023
Release notes
Patch Changes
- Updated dependencies [4b4bc4d7]
- Updated dependencies [30d54d16]
- Updated dependencies [48df28ef]
- Updated dependencies [1d02c811]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.6.114 Oct 2023
Release notes
Patch Changes
- b76f4d1e: Reference search + some app hover states
- Updated dependencies [b76f4d1e]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.6.82 Oct 2023
Release notes
Patch Changes
- Updated dependencies [58af0623]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.6.72 Oct 2023
Release notes
Patch Changes
- cd5f2685: codemirror colors + font fixes throughout app
- Updated dependencies [cd5f2685]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.6.62 Oct 2023
Release notes
Patch Changes
- 8823d7a1: cleanup ui
- Updated dependencies [8823d7a1]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.6.51 Oct 2023
Release notes
Patch Changes
- Updated dependencies [5363374d]
  - @scalar/[email protected]
Open source →
0.6.41 Oct 2023
Release notes
Patch Changes
- 449305f4: marketing content section
- 3e912c75: getting started page design
- 048555c6: feat: add CHANGELOG.md to the package
- df62875a: fix: don’t render tags without endpoints, use path as fallback for the endpoint heading
- Updated dependencies [449305f4]
- Updated dependencies [3e912c75]
- Updated dependencies [048555c6]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.6.329 Sept 2023
Release notes
Patch Changes
- 75a69ba7: feat: add theme prop and improve theme support
- effc1f31: feat: add new HTML API based on script tags chore: deprecate old div based HTML API
- 75a69ba7: refactor: rename @scalar/default-theme to @scalar/themes, add more themes
- b03a09c7: chore: remove Vite env proxy variable
- 11270915: fix: use higher z-index values
- Updated dependencies [75a69ba7]
- Updated dependencies [d6a10e1f]
- Updated dependencies [75a69ba7]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.6.228 Sept 2023
Release notes
Patch Changes
- b184bdf2: codemirror themeing and other theme fixes
- e9861139: feat: pass an already parsed OpenAPI spec to the ApiReference component
- 8751c874: Fix background color not being applied below rendered references
- addd9fa2: feat: use default prefix for all CSS variables
- Updated dependencies [b184bdf2]
- Updated dependencies [6caceb45]
- Updated dependencies [8751c874]
- Updated dependencies [3b1fec80]
- Updated dependencies [addd9fa2]
- Updated dependencies [2006aa43]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.6.122 Sept 2023
Release notes
Patch Changes
- 5a5e760f: fix: use .js as file extension for the browser build
Open source →
0.6.021 Sept 2023
Release notes
Minor Changes
- 87fda5af: chore: update dependencies
Patch Changes
- ef080a26: chore: format package.json
- 9d925e1c: feat: add browser build to the package
- 2cfc8786: feat: add a ton more clients to render example requests
- Updated dependencies [ef080a26]
- Updated dependencies [87fda5af]
- Updated dependencies [45645710]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →
0.5.619 Sept 2023
Release notes
Patch Changes
- 81336114: add yjs support
- Updated dependencies [81336114]
  - @scalar/[email protected]
  - @scalar/[email protected]
  - @scalar/[email protected]
Open source →

@scalar/api-reference

Release timeline

Releases

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes