How to migrate from Bump.sh to Scalar

Last updated: September 2026

Bump.sh is a hosted API documentation platform that publishes both OpenAPI and AsyncAPI documents, with change detection and changelogs built in. Scalar covers most of the same documentation ground, and when you bring your API into Scalar you also get a set of tools that sit around the docs:

• API Client: A modern, open-source API testing client for Windows, macOS and Linux
• SDKs: Generate type-safe client libraries. TypeScript, Python, Go, Java, Kotlin, Ruby, and CLI targets are generally available, with more languages in experimental status
• MCP servers: Hosted MCP servers generated from the same OpenAPI document as your docs
• Spectral Linting: Validate and lint your OpenAPI documents with Spectral rules
• Mock Server: Spin up a fully-functional mock server from your OpenAPI document for frontend development and testing

Be honest with yourself about what you use Bump.sh for, though. If automatic change detection, changelogs, or OpenAPI Overlays are central to how you publish, Bump.sh is stronger there today. Scalar does not generate a semantic diff or a consumer changelog, and it does not apply overlays for you. Scalar does render AsyncAPI documents, but that support is still a work in progress, so check your document before you switch.

Pricing

Scalar has a free plan. As of September 2026, Bump.sh does not; its pricing page offers a 14-day trial on Pro instead.

• Scalar offers a free plan, Bump.sh does not.
• Bump.sh is cheaper at the entry level. Basic at $50/month is a third of Scalar Pro, and if all you need is published OpenAPI docs on a custom domain, that matters.
• Scalar Pro includes 5 editor seats, up to 15 APIs, and one SDK. Business adds SSO and subpath hosting with 10 seats and up to 25 APIs.
• On Bump.sh, diff is on every plan, while the API Explorer, automatic changelog, and branches start at Pro. SSO, custom CSS and JS, embed mode, custom webhooks, and removing Bump.sh branding are listed on Custom only, according to its pricing page.
• Bump.sh offers free Pro access to open source projects on application.

For detailed pricing information, visit Scalar Pricing and Bump.sh Pricing.

Feature Comparison

The Bump.sh column reflects its pricing page as of September 2026. Where a feature needs a specific Bump.sh plan, the plan is noted.

SDKs

Generate type-safe client libraries from your OpenAPI documents. The SDK generator also accepts AsyncAPI and gRPC as inputs; AsyncAPI generation is experimental.

Experimental targets generate working code, but talk to us before you depend on one in production. SDKs sync with your API documentation, so whenever you update your OpenAPI document, your SDKs stay up to date. Learn more in our SDK documentation.

Spectral linting

Validate and lint your OpenAPI documents using Spectral rules. Spectral rules can be managed in the Registry alongside your OpenAPI documents and JSON Schemas.

API prototyping

Spin up a fully-functional mock server from your OpenAPI document. The mock server automatically generates realistic API responses based on your schemas, which is handy for frontend development, API prototyping, and integration testing:

npx @scalar/cli document mock openapi.json --watch

Alternatively, run it in a Docker container or integrate it directly into your Node.js application. Learn more in the Mock Server documentation.

Migrate from Bump.sh to Scalar

While the user interfaces between Bump.sh and Scalar differ, most of what you publish on Bump.sh can be published on Scalar. Migrating your setup will require some manual steps.

However, transitioning via the CLI is typically more straightforward:

Bump CLI → Scalar CLI

Package

Commands

If you rely on overlays, you do not have to give them up. The Bump.sh CLI is MIT licensed, so you can keep running bump overlay in CI to produce the final document, then publish that output to Scalar. The same goes for breaking change checks: keep a diff step in CI alongside Scalar.

Options

Environment Variables

GitHub Actions

Replace:

- uses: bump-sh/github-action@v1
  with:
    doc: my-doc
    token: ${{ secrets.BUMP_TOKEN }}
    file: api.yaml

With:

- run: npx @scalar/cli auth login --token ${{ secrets.SCALAR_API_KEY }}
- run: npx @scalar/cli registry publish api.yaml --namespace my-team --slug my-doc

Authentication

Replace token flags with a one-time login:

# Before (on every command)
bump deploy api.yaml --token $TOKEN

# After (login once, then publish)
scalar auth login --token $TOKEN
scalar registry publish api.yaml --namespace my-team --slug my-doc

Additional Scalar Commands

These commands have no Bump equivalent but may be useful. The full list is in the CLI reference.

Frequently asked questions

Related

• Learn: What is an API reference? · Generate an SDK from OpenAPI
• Docs: Scalar vs Bump.sh comparison · Scalar CLI commands
• Product: Scalar Docs — hosted docs and API references with a free plan and try-it on every plan

Bump.sh details on this page come from its pricing page, help centre, and CLI repository as checked on September 26, 2026. Bump.sh's plans and features may change. If you find something wrong or out of date, please open an issue and we will correct it.