SpecRefit

OPENAPI TOOLING · IN DEVELOPMENT

Your API contract.
Made to fit.

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

A visual workspace for inspecting, adapting and validating OpenAPI specifications. Save your decisions as repeatable rules, ready for the next version.

Follow on GitHub Explore the approach

Desktop, web and Maven integration are planned.
No public release yet.

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

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.

Start with JSON preferences and explicit exceptions. Review the effect of each rule before exporting an adapted specification.

03 / REPEAT

Carry your decisions forward.

Keep the rules in your project. Reapply them to incoming contract versions, with clear feedback when something no longer matches.

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.

We are designing SpecRefit for standalone use on Windows, macOS and Linux, without telemetry or a required account. The optional web editor is planned to process contracts in your browser.

Explicitly configured references may use your network. Internal hosting and local execution remain part of the design.

FOLLOW THE PROJECT

Let's make contracts fit.

SpecRefit is taking shape. Follow the project as the first workflow becomes a working tool.

SpecRefit on GitHub