ScissorHands.Theme
1.0.0-preview.20260914.1
dotnet add package ScissorHands.Theme --version 1.0.0-preview.20260914.1
NuGet\Install-Package ScissorHands.Theme -Version 1.0.0-preview.20260914.1
<PackageReference Include="ScissorHands.Theme" Version="1.0.0-preview.20260914.1" />
<PackageVersion Include="ScissorHands.Theme" Version="1.0.0-preview.20260914.1" />
<PackageReference Include="ScissorHands.Theme" />
paket add ScissorHands.Theme --version 1.0.0-preview.20260914.1
#r "nuget: ScissorHands.Theme, 1.0.0-preview.20260914.1"
#:package ScissorHands.Theme@1.0.0-preview.20260914.1
#addin nuget:?package=ScissorHands.Theme&version=1.0.0-preview.20260914.1&prerelease
#tool nuget:?package=ScissorHands.Theme&version=1.0.0-preview.20260914.1&prerelease
ScissorHands.Theme
ScissorHands.Theme provides the Razor component base types used to build themes for the ScissorHands.NET static site generator.
Install this package when authoring a theme. Applications that only consume a theme should install ScissorHands.Web.
Install
dotnet add package ScissorHands.Theme --prerelease
ScissorHands.NET currently targets .NET 10.
Required components
A theme provides one concrete Razor component derived from each required base type:
MainLayoutBaseIndexViewBasePostViewBasePageViewBaseNotFoundViewBaseTagListViewBaseTagViewBase
Older themes relying on tag-view fallback must add both views; see the migration guidance.
Rendering content
Start from the theme template for the complete layout and discovery setup. A page view renders the content supplied by the engine:
@inherits ScissorHands.Theme.PageViewBase
<article>
@((MarkupString)Document?.Html!)
</article>
The engine prepares routes and NavigationTree; themes control markup, styling, and interaction. A navigation node with Url == null is a non-clickable group. The flat NavigationPages parameter remains available for compatibility.
Use the inherited URL helpers instead of duplicating URL rules in theme files. Render metadata through ordinary Razor expressions to retain encoding. Plugin components select manifests by Id, not display Name.
Optional previous/next page links
The engine supplies optional PageNavigation data for previous/next links. To opt in, forward it through CascadingMainLayoutBase and render the available links in your page view. Existing themes can ignore this data; no new view role is required, and NavigationPages/NavigationTree remain layout-only.
See the adjacent-page context guide for cascading setup, rendering examples, URL handling, and keyboard guidance.
Learn more
- vNext theme guide (website handoff)
- vNext migration reference
- Theme documentation
- Theme template
- ScissorHands.Web package
- Source code
License
ScissorHands.NET is licensed under the MIT License.
| 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
- Microsoft.AspNetCore.Components.Web (>= 10.0.12)
- ScissorHands.Core (>= 1.0.0-preview.20260914.1)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on ScissorHands.Theme:
| Package | Downloads |
|---|---|
|
ScissorHands.Web
The ScissorHands.NET static site generation engine for Markdown content and Razor themes. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.0.0-preview.20260914.1 | 0 | 9/13/2026 |
| 1.0.0-preview.20260913.1 | 60 | 9/13/2026 |
| 1.0.0-preview.20260912.1 | 47 | 9/11/2026 |