Theneo.AspNetCore
0.1.0
dotnet add package Theneo.AspNetCore --version 0.1.0
NuGet\Install-Package Theneo.AspNetCore -Version 0.1.0
<PackageReference Include="Theneo.AspNetCore" Version="0.1.0" />
<PackageVersion Include="Theneo.AspNetCore" Version="0.1.0" />
<PackageReference Include="Theneo.AspNetCore" />
paket add Theneo.AspNetCore --version 0.1.0
#r "nuget: Theneo.AspNetCore, 0.1.0"
#:package Theneo.AspNetCore@0.1.0
#addin nuget:?package=Theneo.AspNetCore&version=0.1.0
#tool nuget:?package=Theneo.AspNetCore&version=0.1.0
Theneo.AspNetCore
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 | Versions 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. |
-
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 |