View on GitHub
SpecRefit

OPENAPI TOOLING · VERSION 0.2.0

Your API contract.
Made to fit.

Understand the spec you're given.
Shape the contract your project needs.

A local workspace for inspecting and adapting OpenAPI specifications. Choose media types, extract shared models and bundle references, then review and export your changes.

Available for Windows, macOS and Linux, with bundled runtimes.
Early 0.x release · unsigned Windows packages · macOS not notarized.

contract / previewILLUSTRATION
GET/pets200 OK

AVAILABLE RESPONSE TYPES

application/json application/xml

Prefer JSON

Keep JSON where the contract offers it.

RESULTING RESPONSE TYPES

application/json

JSON selected. XML removed from this response.

One decision. A repeatable transformation.

Interactive concept preview · no files or API calls

Built for developersLocal execution by designRules you can version

GET SPECREFIT

Inspect. Adapt. Export.

Open local YAML or JSON contracts, inspect operations and schemas, choose transformations and export the reviewed result.

DEVELOPMENT DOWNLOADS

Fresh from main.

Successful main builds publish browser files and runtime-inclusive Windows, macOS and Linux packages. One rolling preview always contains the newest verified downloads, with checksums and build details.

Current development preview ↗

BROWSER PREVIEW

Your files stay local.

Try the current development editor in your browser. Contract files stay on your device; no account or installation is needed. Reloading clears the session.

Open the playground ↗

STABLE RELEASES

Version 0.2.0.

Download Windows x64, macOS Apple Silicon or Intel, Linux x64, or browser assets. Release notes include checksums, startup instructions and current support limits. Installers, CLI and Maven artifacts remain planned.

Latest release ↗

FROM SPECIFICATION TO PROJECT

Keep the contract.
Make the choices explicit.

Contract changes should be understandable, reviewable and reproducible.

01 / INSPECT

See how it fits together.

Explore operations, schemas, references and security requirements. Understand what goes in, what comes out and where the contract needs attention.

02 / REFIT

Choose what you need.

Select one or more media types, extract shared models and bundle external references. Review the effect of each rule before exporting an adapted specification.

03 / REPEAT

Carry your decisions forward.

Next: save rules in your project and replay them against incoming contract versions. Project configuration and CLI replay are planned.

DESIGNED FOR YOUR TOOLCHAIN

Visual choices.
Repeatable builds.

The editor will save a specrefit.yaml configuration. The planned Maven plugin will apply those rules during your build and hand the resulting OpenAPI contract to Fabrikt or another generator.

The output remains an OpenAPI specification.

  1. 01
    Source contractOpenAPI specification
  2. 02
    SpecRefit + your rulesspecrefit.yaml
  3. 03
    Adapted contractReady for your generator

YOUR CONTRACTS, YOUR ENVIRONMENT

Local comes first.

The browser and desktop editor process contracts locally, without telemetry or a required account. Windows, macOS and Linux packages include their runtime.

Desktop imports discover local relative references inside the selected directory tree. In the browser, select a folder or supply missing files. Optional, explicitly configured network retrieval remains planned.

FOLLOW THE PROJECT

Let's make contracts fit.

Try the latest release and follow the next steps toward saved projects and repeatable builds.

SpecRefit on GitHub