Skip to content

Releases

SpecRefit 0.2.0

Choose a tag to compare

@mrhoeve mrhoeve released this 05 Oct 06:31
3dffeb3

SpecRefit 0.2.0

SpecRefit 0.2.0 improves everyday work with larger, multi-file OpenAPI contracts. It builds on the inspection, transformation and reviewed export workflow introduced in 0.1.0.

What's improved

  • Automatic local references on desktop. Open an entry contract and SpecRefit discovers relative reference files recursively inside its directory tree. Missing or inaccessible references produce diagnostics; all discovered source files remain protected from export writes. Files outside the selected tree and remote URLs are not fetched automatically. Browser users can still select a folder or supply missing files explicitly. (#32)
  • One contract-wide media preference. Choose one or more request/response media types actually offered by the specification, including JSON, XML, text and multipart. Single-type content is preserved. With multiple types, selected matches are retained; when none match, the original types are kept. All types start selected, including multipart, so capabilities are removed only through an explicit choice. (#34)
  • Better small-window navigation. Compact operation/filter navigation and independently scrolling details keep the workspace usable when resizing browser or desktop windows. The version header stays compact. (#15)
  • Clear playground build identity. The hosted playground shows the published release version at its release commit, or a development banner with the release baseline, commit count and linked commit hash for newer builds. Stable release publication automatically rebuilds the current main playground behind the complete Build gate. (#35)
  • Fresh playground visits without a hard refresh. A small same-origin startup check refreshes stale HTML before starting the editor; app, worker, stylesheet and logo files use content-based names. Failed checks show a retry instead of silently starting stale code. Open editing sessions are not automatically reloaded, and desktop/local startup stays offline. During the initial rollout, pages cached before this mechanism existed may still need one final hard refresh or cache expiry. (#36)

Contract processing remains local, without accounts, telemetry or a processing server. The hosted startup check retrieves only application build identity and sends no contract data.

Downloads and upgrading

Download the archive matching your platform, extract it into a new folder and launch SpecRefit.exe on Windows, SpecRefit.app on macOS or SpecRefit on Linux. Export any work you need before closing an existing session. No separate Node.js or Electron installation is required; Linux needs a graphical session and Chromium system libraries. The browser archive contains static files for hosting, not a desktop executable.

The release provides Windows x64, macOS Apple Silicon and Intel, Linux x64 and browser archives, plus manifest.json and SHA256SUMS for build identity and integrity verification. GitHub's automatically generated source archives are not runtime-inclusive applications.

Windows packages remain unsigned. macOS packages have ad-hoc signatures without Developer ID or notarization, so downloaded apps may be blocked by OS security policy. Native CI tests startup, shared-engine behavior and export from extracted packages without Node on PATH; full clean-machine and browser-download quarantine acceptance remain open. Native installers are not included.

Scope

Representative OpenAPI 3.0.4, 3.1.2 and 3.2.0 fixtures are tested. SpecRefit is not a complete OpenAPI or JSON Schema validator. Broader reference/dialect semantics, saved project configuration, contract comparison, CLI and Maven integration remain planned. This 0.x release does not imply completion of the roadmap or a compatibility guarantee for future versions.

SpecRefit is licensed under Apache-2.0 and developed with the assistance of ChatGPT Codex.

All changes since 0.1.0

Development preview

Development preview Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 05 Oct 07:13
8c4ffff

Rolling development preview — not a stable release. Replaced after successful main builds.

Version: 0.0.0-dev+g8c4ffff2512d
Commit: 8c4ffff2512dce28296771a72de4ad92dcaf4528
Build: https://github.com/SpecRefit/specrefit/actions/runs/37276150307

Downloads: browser assets and portable desktop packages for Windows x64, macOS Apple Silicon/Intel and Linux x64, including the Electron runtime. Extract the archive and launch SpecRefit.exe, SpecRefit.app or SpecRefit. Windows is unsigned; macOS has only an ad-hoc signature, with no Developer ID or notarization. OS security policy may block these development builds. Linux system libraries remain prerequisites. Manifest and SHA-256 checksums identify the complete tested set. Installers, CLI and Maven packages remain planned.

Latest is reserved for stable releases. This preview may be briefly unavailable during replacement; failed publication can be retried.

SpecRefit 0.1.0

Choose a tag to compare

@mrhoeve mrhoeve released this 02 Oct 23:18
419a7a8

SpecRefit 0.1.0

The first versioned SpecRefit release brings local OpenAPI inspection, targeted transformations and reviewed export to the browser and desktop. Contract processing stays on your machine, without accounts, telemetry or a processing server.

Included

  • Import YAML/JSON contracts and reference files; browse and search operations, parameters, request bodies, responses, security and schemas.
  • Select one or more media types, extract inline schemas into explicitly named shared models and bundle external references into one document within the documented support boundaries.
  • Preview changes and export the reviewed files. Browser exports use a ZIP for multiple files; desktop exports write to the chosen folder with source-file protection.
  • Follow the system theme or switch between light and dark.
  • Portable desktop packages with a bundled Electron runtime for Windows x64, macOS Apple Silicon/Intel and Linux x64, plus browser assets, a manifest and SHA-256 checksums.

Downloads

Extract the entire desktop archive, then launch SpecRefit.exe on Windows, SpecRefit.app on macOS or SpecRefit on Linux. No separate Node.js or Electron installation is needed. Linux requires a graphical session and Chromium system libraries. The web archive contains static browser assets for hosting; it is not the Windows application.

Windows packages are unsigned. macOS packages use ad-hoc signatures without Developer ID or notarization; downloaded apps may be blocked by OS security policy. Native CI tests startup and export from the extracted packages, but full clean-machine and browser-download quarantine acceptance remain open. Native installers are not included.

Scope of this first release

Representative OpenAPI 3.0.4, 3.1.2 and 3.2.0 fixtures are covered; SpecRefit is not a complete OpenAPI or JSON Schema validator. Broader reference/dialect semantics, project configuration persistence, contract comparison, CLI and Maven integration remain planned. Consult the repository's support documentation before relying on unsupported constructs. This 0.x release does not imply completion of the full product roadmap or a compatibility guarantee for future versions.

SpecRefit is licensed under Apache-2.0 and developed with the assistance of ChatGPT Codex.

Verification and follow-up

The v0.1.0 build passed browser/engine checks and native package tests on all four desktop targets. The manifest identifies commit 419a7a8; SHA256SUMS covers all five downloadable archives.

Smaller-window layout improvements are tracked separately in issue #13.