Program.cs

using ShellDocs.Components;
using ShellDocs.Site.Components;

var builder = WebApplication.CreateBuilder(args);

builder.WebHost.UseStaticWebAssets();

builder.Services.AddRazorComponents()
 .AddInteractiveServerComponents();

builder.Services.AddShellDocs(o =>
{
 o.ContentRoot = Path.Combine(builder.Environment.ContentRootPath, "content");
 o.SiteName = "ShellDocs";
 o.SiteTagline = "The docs framework for .NET.";
 o.GitHubRepo = "shellui-dev/shelldocs";
 o.LayoutVariant = DocsLayoutVariant.Sidebar;

 // Top nav: three tabs. Package-specific navigation lives entirely in the
 // sidebar's package selector, not up here.
 o.AddNavLink("Documentation", "/docs/introduction");
 o.AddNavLink("Releases", "https://github.com/shellui-dev/shelldocs/releases");
 o.AddNavLink("Sponsor", "https://github.com/sponsors/shellui-dev");

 // Sidebar package selector: the ShellDocs family. Landing pages live as
 // flat top-level files under /docs/ so they don't create a duplicate
 // "Packages" section in the lower sidebar tree.
 o.AddPackage("shelldocs", "ShellDocs", "The framework: install, scaffold, author.", "/docs/introduction",
 "M12 2 4 6v6c0 5 3.5 9.5 8 10 4.5-.5 8-5 8-10V6z");
 o.AddPackage("shelldocs.components","ShellDocs.Components","Chrome + content primitives: Callout, Card, Steps, more.","/docs/packages/components",
 "M3 3h7v7H3z M14 3h7v7h-7z M3 14h7v7H3z M14 14h7v7h-7z");
 o.AddPackage("shelldocs.markdown", "ShellDocs.Markdown", "The Markdig pipeline behind every rendered page.", "/docs/packages/markdown",
 "M4 4h16v16H4z M4 9h16 M9 4v16");
 o.AddPackage("shelldocs.cli", "ShellDocs.CLI", "shelldocs init, add, dev, build.", "/docs/packages/cli",
 "m8 6-6 6 6 6 M16 6l6 6-6 6");
 o.AddPackage("shelldocs.core", "ShellDocs.Core", "Nav graph, search index, plain-text extraction.", "/docs/packages/core",
 "M12 2 2 7l10 5 10-5-10-5z M2 17l10 5 10-5 M2 12l10 5 10-5");
 o.AddPackage("shelldocs.tokens", "ShellDocs.Tokens", "Design-system CSS variables. Interoperable with shadcn.","/docs/packages/tokens",
 "M12 2 2 7v10l10 5 10-5V7z");
});

var app = builder.Build();

app.UseStaticFiles();
app.UseAntiforgery();

app.MapRazorComponents<App>()
 .AddInteractiveServerRenderMode();

app.Run();