ShellDocs.Components
0.1.18-alpha
See the version list below for details.
dotnet add package ShellDocs.Components --version 0.1.18-alpha
NuGet\Install-Package ShellDocs.Components -Version 0.1.18-alpha
<PackageReference Include="ShellDocs.Components" Version="0.1.18-alpha" />
<PackageVersion Include="ShellDocs.Components" Version="0.1.18-alpha" />
<PackageReference Include="ShellDocs.Components" />
paket add ShellDocs.Components --version 0.1.18-alpha
#r "nuget: ShellDocs.Components, 0.1.18-alpha"
#:package ShellDocs.Components@0.1.18-alpha
#addin nuget:?package=ShellDocs.Components&version=0.1.18-alpha&prerelease
#tool nuget:?package=ShellDocs.Components&version=0.1.18-alpha&prerelease
ShellDocs.Components
The Blazor side of ShellDocs, the docs framework for .NET: the docs layout and chrome (sidebar, header, search, table of contents, version and package selectors) and the content components you write in Markdown (Callout, Card, Steps, Tabs, CodeGroup, FileTree, TypeTable, live component previews).
Install
The quickest start is the CLI, which scaffolds a site with everything wired up:
dotnet tool install --global ShellDocs.CLI --prerelease
shelldocs init
To add ShellDocs to an existing Blazor Web App:
dotnet add package ShellDocs.Components --prerelease
builder.Services.AddShellDocs(o =>
{
o.ContentRoot = Path.Combine(builder.Environment.ContentRootPath, "content");
o.SiteName = "My Library";
o.RegisterComponentsFromAssembly<MyLib.Button>(); // your components, usable in Markdown
});
shelldocs init --attach does this for you and writes the App.razor snippets into SHELLDOCS_SETUP.md.
What you get
- Markdown-first authoring. Frontmatter, highlighted code fences, live
razor:previewexamples and component tags mid-prose. - File-based navigation. Each
.mdundercontent/docs/is a page;meta.jsonsets order, dividers, subsections and hidden pages. Cmd+Ksearch with body snippets, searched in the browser.- Colour presets (
o.Theme = ShellDocsTheme.Harbor), light and dark. - Versioned docs, redirects and llms.txt for AI agents.
- Works as a static site.
shelldocs buildexports every page, and the chrome keeps working there throughshelldocs.js.
Links
- Docs: shelldocs.shellui.dev
- Source, issues and changelog: github.com/shellui-dev/shelldocs
Alpha: APIs may change between minor versions. MIT licensed.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. 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. |
-
net10.0
- ShellDocs.Core (>= 0.1.18-alpha)
- ShellDocs.Markdown (>= 0.1.18-alpha)
- ShellDocs.Tokens (>= 0.1.18-alpha)
- ShellIcons.Blazor (>= 0.1.0-alpha)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.1.19-alpha | 63 | 10/21/2026 |
| 0.1.18-alpha | 52 | 10/20/2026 |
| 0.1.17-alpha | 79 | 10/14/2026 |
| 0.1.16-alpha | 48 | 10/14/2026 |
| 0.1.15-alpha | 66 | 10/11/2026 |
| 0.1.14-alpha | 60 | 10/10/2026 |
| 0.1.13-alpha | 53 | 10/10/2026 |
| 0.1.12-alpha | 67 | 10/4/2026 |
| 0.1.11-alpha | 73 | 10/3/2026 |
| 0.1.10-alpha | 67 | 10/2/2026 |
| 0.1.9-alpha | 62 | 10/2/2026 |
| 0.1.8-alpha | 62 | 10/2/2026 |
| 0.1.7-alpha | 105 | 9/7/2026 |
| 0.1.6-alpha | 85 | 8/29/2026 |
| 0.1.5-alpha | 80 | 8/29/2026 |
| 0.1.3-alpha | 100 | 8/11/2026 |
| 0.1.2-alpha | 97 | 7/28/2026 |
| 0.1.1-alpha | 84 | 7/25/2026 |
| 0.1.0-alpha | 109 | 7/25/2026 |