What OpenDoc UI understands, where it runs, and which ecosystems it speaks.
From legacy Swagger documents to the newest OpenAPI 3.2 constructs — parsed, normalized and rendered correctly, including vendor extensions and webhooks.
| Dialect | Parsing | Rendering | Runner | Notes |
|---|---|---|---|---|
| openapi: 3.0.x | Complete | Complete | Supported | nullable semantics preserved; parameters, security, callbacks and links rendered |
| openapi: 3.1.x | Complete | Complete | Supported | JSON Schema 2020-12 keywords — const, prefixItems, unevaluatedProperties, if/then/else, type unions |
| openapi: 3.2.x | Complete | Complete | Supported | webhooks, additionalOperations, first-class QUERY (RFC 10008) with bodies, newest meta-schema surface |
| swagger: "2.0" | Complete | Normalized to 3.x | Supported | definitions, formData and body parameters, file uploads, collection formats, securityDefinitions |
Multi-file documents resolve in-memory: local reference graphs, same-origin external references and bundled documents are all handled, with clear diagnostics for anything unresolved. An Experimental load-time YAML repair can recover flow-style combinators that omit sequence brackets — originals on disk are never rewritten.
GitHub Pages, Netlify, Vercel, Cloudflare Pages, S3 and any nginx or Apache static server. A single dist/ directory is all that is required — no runtime, no database.
A compose-based image serves the verified bundle from nginx with a health check, reproducible lockfile builds and cross-platform helper scripts for Windows, macOS and Linux.
Modern evergreen browsers on desktop and mobile: Chromium, Firefox, Safari and Edge. The interface adapts to small screens with a mobile sidebar and touch-friendly interactions.
OpenAI, Anthropic, Ollama, OpenRouter or any OpenAI-compatible endpoint reachable from the browser, with global profiles for keys, models, temperature and skills.
The included hardened gateway owns provider credentials and enforces token authentication, origin allowlists, rate limits, concurrency bounds and upstream timeouts.
Gateway reference implementations for Node (Express), Python (FastAPI, Django), PHP (Laravel), Ruby (Rails), Java (Spring Boot), .NET (ASP.NET Core), Go (Gin) and Rust (Axum).
When a specification URL can't be fetched directly from the browser, a tiny proxy agent fetches it for you. Reference implementations ship in six frameworks:
The interface localizes cleanly, and specification content renders exactly as authored — descriptions, Markdown and examples included.
The Runner Compatibility report states plainly what the browser can and cannot do for a given API — CORS constraints, credentialed requests, cookie behavior — before you waste a minute wondering.
