FAQ

FAQ

Does Folio work with Swagger UI / Scalar's OpenAPI setup? Yes — Folio doesn't generate the OpenAPI document itself, it only renders one. Anything that produces a spec (Microsoft.AspNetCore.OpenApi, Swashbuckle, NSwag, a static file) works.

Does it need an internet connection? No. Fonts, Tailwind CSS, and every vendored script are bundled into the package assembly as embedded resources. Zero external requests, both at build time and in the browser.

Does AuthorizationPolicy/AddFolioAuth() protect my API, not just the docs page? No — see the scope note at the top of Authorization. Both approaches only gate the Folio UI itself. Your OpenAPI JSON endpoint and your actual API endpoints need their own protection.

Can I run multiple Folio instances for multiple specs in one app? Call UseFolio(...) more than once with a different RoutePrefix and SpecUrl each time.

Why isn't there a license file? Deliberate choice for now — the package ships without an explicit license.

Which .NET versions are supported? net6.0, net7.0, net8.0, and net9.0 — see the CHANGELOG for when each was added.

Where do I report a bug or request a feature? GitHub Issues.