FlexDoc is Prauga's open-source, self-hosted OpenAPI documentation renderer, Try It explorer and local API workspace. The 2.8 milestone closes broad framework coverage while keeping one canonical renderer and request model across docs, execution, API Client handoff, saved workspaces and generated code.
FlexDoc 2.8 is a product milestone, not a forced package-version lockstep. Choose the framework you already run and get the independently versioned package, install command and minimal native integration for that stack.
FlexDoc 2.8 uses one renderer contract across independently versioned packages. Pick the framework you already run and this panel shows the package, exact version and smallest useful integration path.
npm install @prauga/flexdoc-client@2.8.0import { FlexDoc } from '@prauga/flexdoc-client';
import '@prauga/flexdoc-client/styles.css';
export function Docs({ spec }) {
return <FlexDoc spec={spec} options={{ tryIt: { enabled: true } }} />;
}/docs. Renderer assets are packaged locally with the selected integration, so no FlexDoc account or runtime CDN is required.These screenshots are captured from this site running Prauga's canonical renderer with a full-surface OpenAPI setup: regional server variables, authentication, advanced parameters, nested schemas, Try It, live response inspection and generated request code. The images automatically match this site's light or dark theme.
The capture fills advanced request inputs, sends the request, renders the response and hands the exact built request into the editable API Client — all through the same canonical request model.
The published workspace layers collections, arbitrarily nested folders, collection and environment variables, hierarchical auth with OAuth grants, trusted scripts, persisted tests/history and Postman Collection v2.1/environment import around the same canonical HTTP editor used by Try It.
Open API Client workspace
FlexDoc 2.8 is the coordinated catch-up release for the API Client: nested workspaces, layered variables, inherited auth/OAuth, scripting, persisted tests/history, canonical Try It handoff and Postman import now ship together. The same renderer contract still spans React/Node and every supported native adapter without runtime CDN or hosted-service requirements.
Edit parameters, bodies and authentication, choose servers, send the request and inspect the live response without leaving the docs.
Snapshot the built OpenAPI request into an editable HTTP client with method, URL, query, headers, auth, body, custom servers and response inspection.
Import Postman Collection v2.1 and environment exports into native FlexDoc collections, folders, variables, auth and scripts with explicit compatibility warnings.
React/Node, .NET, JVM, Python, PHP, Ruby, Go, Rust and Elixir hosts share the renderer contract instead of reimplementing OpenAPI behavior per framework.
Normalization, composition, recursive schemas, local and relative external references, server variables and richer parameter serialization.
cURL, JavaScript, Python, Go and Java samples are generated from the same canonical request model that powers Try It.
Responsive navigation, endpoint search and stable operation hashes make large API references easier to browse and share.
No FlexDoc account, hosted dashboard, telemetry service or runtime CDN is required. Renderer assets ship with the integration.
FlexDoc 2.8 carries the complete 2.4–2.7 workspace work into one coordinated release and adds Postman import: nested collections, layered variables, hierarchical auth, OAuth grants, scripts, persisted tests/history, canonical Try It handoff and compatibility-aware migration all use the same request model.
FlexDoc keeps each ecosystem's own OpenAPI generator and HTTP primitives. Thin hosts serve the same packaged renderer contract, so adding a framework does not mean rebuilding navigation, schemas, Try It or the API Client.
OpenAPI Try It itself uses supplied OAuth/OpenID tokens; interactive OAuth grant acquisition lives in the API Client workspace and requires browser-compatible redirect/CORS behavior.
OAuth client secrets entered in the browser are not confidential. Token acquisition/refresh is explicit, and expires_in is informational rather than an automatic refresh scheduler.
deepObject is first-class for flat object properties; nested deep-object expansion is not recursive.
multipart requests use FormData, but binary file picking is not yet a first-class renderer control.
patternProperties / JSON Schema conditionals, webhooks, callbacks and XML metadata are retained or partially modeled but are not complete first-class interactive surfaces.
Postman multipart/file fields cannot recreate browser File objects; they import as reviewable text with compatibility warnings, and unsupported Postman sandbox/auth behavior is never silently treated as equivalent.
API Client scripts are trusted local JavaScript, not a security sandbox. Persisted workspace secrets are stored as entered in the browser origin.
template expansion is one pass; request chaining (flex.sendRequest), cookie scripting APIs and external package imports remain future scripting layers.
Swagger/OpenAPI 2.0 is not accepted; integrations should generate OpenAPI 3.x.
Framework adapters no longer implement their own parsing, schemas, code generation or Try It behavior. They obtain the OpenAPI document and host version-matched FlexDoc renderer assets.
FlexDoc renderer assets are packaged with the integration. Documentation-route credentials are validated server-side and are not serialized into browser configuration. You control the API, the docs route and the deployment.
The browser workspace persists collections, nested folders, saved requests, collection/environment variables, layered auth, scripts, response tests and contextual request history locally. Try It hands off a canonical session with request, server and supported authorization context so workspace features build on request semantics instead of duplicating them.
FlexDoc 2.8 is open source under AGPL-3.0-or-later. Use the live demo, use the install selector above, or inspect the architecture on GitHub.