APIShift
API contracts, made legible
An API can look right and still break a client. APIShift compares OpenAPI specifications and makes those compatibility risks visible before a change ships.
- TypeScript
- React
- OpenAPI 3.0 / 3.1
- Web Workers
- Vitest

Read the engineering case study
The problem
API reviewers need to understand what a contract change means for existing consumers. A diff alone does not explain whether a narrower request or a wider response will break them.
The approach
A deterministic comparison engine, separated from the interface, parses and validates two specifications and produces ordered findings with before/after values, explanations, and suggested actions.
Decisions that matter
Keep the contracts in the browser
Parsing and comparison run in a dedicated Web Worker. Specification files stay in tab memory; the tool makes no external requests after load.
Make uncertainty visible
Advanced schema semantics and unsupported features are reported explicitly. A partial understanding never becomes a false clean bill of health.
Make reviews repeatable
Stable ordering and identifiers produce byte-identical JSON and Markdown reports for identical inputs. An eight-second watchdog bounds worker execution.
Evidence & boundaries
The CV and public README document 99 unit tests and 14 browser workflow tests, with lint, type checks, builds, and browser tests in GitHub Actions. These are repository-reported results, not a fresh test run of APIShift.
A compatibility analyzer for a documented subset of OpenAPI, rather than a full schema validator or a guarantee of runtime compatibility.
Read the source documentation
