Theneo.AspNetCore 0.1.0

dotnet add package Theneo.AspNetCore --version 0.1.0
                    
NuGet\Install-Package Theneo.AspNetCore -Version 0.1.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Theneo.AspNetCore" Version="0.1.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Theneo.AspNetCore" Version="0.1.0" />
                    
Directory.Packages.props
<PackageReference Include="Theneo.AspNetCore" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Theneo.AspNetCore --version 0.1.0
                    
#r "nuget: Theneo.AspNetCore, 0.1.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Theneo.AspNetCore@0.1.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Theneo.AspNetCore&version=0.1.0
                    
Install as a Cake Addin
#tool nuget:?package=Theneo.AspNetCore&version=0.1.0
                    
Install as a Cake Tool

Theneo.AspNetCore

NuGet

Serve a beautiful Theneo API Reference for your OpenAPI document from any ASP.NET Core app — with a single line:

app.MapTheneoApiReference();

The viewer's JavaScript bundle is embedded in the NuGet package as a static resource, so there's no CDN dependency and it works for air-gapped / enterprise installs.

This package renders an OpenAPI document you already have. For zero-config OpenAPI generation from your controllers' source code (no Swashbuckle, no annotations), install Theneo.AspNetCore.Scanning alongside this package and call MapTheneoApiReferenceWithScanning(...). It's a separate package because it pulls in Roslyn/MSBuild — keeping this renderer lightweight for the common case. See its README for usage.

Install

dotnet add package Theneo.AspNetCore

The package targets net8.0 and net9.0 and bundles the viewer's JavaScript and CSS inside the assembly — no CDN and no extra package references.

Developing against the local source

If you're working inside the theneo-reference-api monorepo (rather than consuming the published package), reference the project directly. The embedded viewer bundle is produced by the JS workspace, so build it first:

# from the repo root — produces packages/vanilla/dist that the csproj embeds
yarn install
yarn turbo run build --filter=@theneo/vanilla
# then reference the project from your app
dotnet add reference ../../../integrations/dotnet/aspnetcore/Theneo.AspNetCore.csproj

If the bundle hasn't been built, the build fails early with a message pointing you at the yarn command above.

Usage

using Theneo.AspNetCore;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddOpenApi();                 // Microsoft.AspNetCore.OpenApi

var app = builder.Build();
app.MapOpenApi("/openapi.json");               // serve the OpenAPI document

app.MapTheneoApiReference(options =>
{
    options.Title = "My API";
    options.SpecUrl = "/openapi.json";         // default
    options.RoutePattern = "/theneo";          // default
});

app.Run();

Browse to /theneo to view the reference.

MapTheneoApiReference returns an IEndpointConventionBuilder, so you can chain endpoint conventions — for example, to require auth:

app.MapTheneoApiReference().RequireAuthorization();

Options

Option Type Default Description
Title string "API Reference" Page title and viewer header.
SpecUrl string "/openapi.json" URL the viewer fetches the OpenAPI document from.
RoutePattern string "/theneo" Path the viewer (and its assets) are served at.
PoweredByTheneo bool true Show the "Powered by Theneo" attribution.
TheneoProjectId string? null Theneo project id; surfaces a "View full documentation on Theneo" banner.
TheneoGuidesUrl string? null Override the "View on Theneo" link target (defaults to https://theneo.io/{TheneoProjectId}).
Theme string "auto" "light", "dark", or "auto".

Screenshot

Screenshot coming soon.

Target frameworks

net8.0 and net9.0.

License

MIT — part of the theneo-reference-api monorepo.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net8.0

    • No dependencies.
  • net9.0

    • No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Theneo.AspNetCore:

Package Downloads
Theneo.AspNetCore.Scanning

Zero-config auto-scan for the Theneo.AspNetCore reference viewer. Adds `MapTheneoApiReferenceWithScanning(...)`, which scans your ASP.NET Core controllers' source with Roslyn at startup and serves the generated OpenAPI document to the viewer — no Swashbuckle, no annotations. Pulls in Roslyn/MSBuild; keep it out of your renderer path unless you want auto-scan.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.1.0 122 10/20/2026