RicoSuter/NSwag

Health v2 · maintenance only

Adoption not part of the score

7358 stars · 1357 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

NSwag is a Swagger/OpenAPI 2.0 and 3.0 toolchain for .NET, ASP.NET Core, and TypeScript, written in C#. It generates OpenAPI specifications from ASP.NET Web API controllers and generates C# and TypeScript client code from those specifications, combining Swashbuckle and AutoRest functionality in one tool.

Use cases

• generate openapi spec from asp.net core controllers
• generate typescript client from swagger json
• generate c# api client from openapi 3.0 spec
• serve swagger ui in asp.net core app
• generate angular client code for rest api
• keep api clients in sync with webapi controllers

When to choose

• you have ASP.NET (Core) Web API controllers and want OpenAPI docs and typed clients
• you need both spec generation and client code generation in one consistent toolchain
• you target TypeScript frameworks like Angular and want generated API clients
• you need better support for inheritance, enums, and reference handling than Swashbuckle alone

When to avoid

• your API is not .NET-based and you only need client generation (AutoRest/openapi-generator may fit better)
• you only need minimal Swagger UI hosting without code generation
• you work outside the .NET/TypeScript ecosystem

Facets

library · maturity active

api-framework api-documentation middleware http-server apis web-development backend developer-tools documentation dotnet windows cross-platform cli openapi swagger typescript-client csharp-client aspnetcore code-generation webapi codegen linux macos

Member repositories

For agents

markdown · JSON · MCP: product_card(name="RicoSuter/NSwag")