BlazingStory.ToolKit 1.0.0-preview.79

This is a prerelease version of BlazingStory.ToolKit.
dotnet add package BlazingStory.ToolKit --version 1.0.0-preview.79
                    
NuGet\Install-Package BlazingStory.ToolKit -Version 1.0.0-preview.79
                    
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="BlazingStory.ToolKit" Version="1.0.0-preview.79" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="BlazingStory.ToolKit" Version="1.0.0-preview.79" />
                    
Directory.Packages.props
<PackageReference Include="BlazingStory.ToolKit" />
                    
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 BlazingStory.ToolKit --version 1.0.0-preview.79
                    
#r "nuget: BlazingStory.ToolKit, 1.0.0-preview.79"
                    
#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 BlazingStory.ToolKit@1.0.0-preview.79
                    
#: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=BlazingStory.ToolKit&version=1.0.0-preview.79&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=BlazingStory.ToolKit&version=1.0.0-preview.79&prerelease
                    
Install as a Cake Tool

alternate text is missing from this package README image Blazing Story

tests NuGet Package Discord

📝 Summary

The clone of "Storybook" for Blazor — a frontend workshop for building UI components and pages in isolation.

alternate text is missing from this package README image

Built almost 100% on Blazor native (only a few JavaScript helpers), so you can create a UI catalog application the Blazor way — no npm, package.json, webpack, or JS/TS code required.

Blazing Story also provides an MCP server feature that exposes component and story information to AI agents for highly accurate code generation.

👉 Try the live demo: https://jsakamoto.github.io/BlazingStory/

🚀 Getting Started

This walkthrough assumes you already have a Blazor app project (e.g. MyBlazorApp1) with components you want to catalog.

1. Install the project template (one-time)

dotnet new install BlazingStory.ProjectTemplates

2. Create a Blazing Story app project

Add a Blazing Story app project alongside your existing app:

# For Blazor WebAssembly:
dotnet new blazingstorywasm -n MyBlazorApp1.Stories

# For Blazor Server (add -mcp to enable the MCP server feature):
dotnet new blazingstoryserver -n MyBlazorApp1.Stories

dotnet sln add ./MyBlazorApp1.Stories/

The MCP server feature is only available with the Blazor Server variant.

Visual Studio users can do the equivalent through Add → New Project and pick the "Blazing Story (WebAssembly App)" or "Blazing Story (Server App)" template.

3. Reference your component project

dotnet add ./MyBlazorApp1.Stories reference ./MyBlazorApp1

4. Add a story file

Place a *.stories.razor file (typically under a Stories/ folder) in the Blazing Story app project:

@* MyBlazorApp1.Stories/Stories/Button.stories.razor *@
@using MyBlazorApp1.Components
@attribute [Stories("Components/Button")]

<Stories TComponent="Button">
    <Story Name="Primary">
        <Template>
            <Button Label="Button" Primary="true" @attributes="context.Args" />
        </Template>
    </Story>
</Stories>

The file name must end with .stories.razor — this is required by the "Show code" feature on the "Docs" pages.

5. Run it!

dotnet run --project ./MyBlazorApp1.Stories

🎉 You'll see the Storybook clone built on Blazor!

alternate text is missing from this package README image

📓 Documentation

For advanced topics — story structure, args, controls, decorators, addons, and more — see the Blazing Story Documentation Site.

🤖 AI Agent Skills

Agent skills are published to help AI coding assistants implement stories and custom addons for Blazing Story:

  • blazing-story-story — generate .stories.razor files for your components
  • blazing-story-addon — scaffold and register custom addons (toolbar, panel, preview decorator)

Install with GitHub CLI (v2.90.0+):

gh skill install BlazingStory/agent-skills blazing-story-story
gh skill install BlazingStory/agent-skills blazing-story-addon

For details and the latest information, see the upstream repository: https://github.com/BlazingStory/agent-skills

📌 System Requirements

.NET SDK 8 or later

⚠️ Caveat

Assembly files of a Blazing Story app embed the project file path as metadata.

alternate text is missing from this package README image

If the project path must remain confidential, avoid using Blazing Story.

🙇 Disclaimer

Blazing Story is a personal hobby project and a technical exhibition — it is not an officially derived product of Storybook. I plan to keep improving it, but it may be abandoned if I cannot spend enough time on it. Forks and community maintenance are welcome.

Because Blazing Story is a Blazor-native re-implementation that mimics Storybook's look, behavior, and functionality, none of the Storybook community's contributions, addons, or related services are available here. The trade-off is that Blazor developers get a Storybook-like component catalog within the familiar .NET ecosystem, free from the JavaScript front-end toolchain.

🎉 Release Notes

See RELEASE-NOTES.txt.

📢 License & Third Party Notice

Mozilla Public License Version 2.0

The third party notice is here.

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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on BlazingStory.ToolKit:

Package Downloads
BlazingStory

The clone of "Storybook" for Blazor, a frontend workshop for building UI components and pages in isolation.

BlazingStory.Addons.BuiltIns

The clone of "Storybook" for Blazor, a frontend workshop for building UI components and pages in isolation.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0-preview.79 172 5/16/2026
1.0.0-preview.78 1,507 4/27/2026
1.0.0-preview.77 921 4/22/2026
1.0.0-preview.76 2,188 4/12/2026
1.0.0-preview.75 1,193 4/4/2026
1.0.0-preview.74 274 4/2/2026
1.0.0-preview.73 166 3/31/2026
1.0.0-preview.72 304 3/28/2026
1.0.0-preview.71 61 3/28/2026
1.0.0-preview.70 770 3/26/2026
1.0.0-preview.69 101 3/24/2026
1.0.0-preview.68 124 3/24/2026

v.1.0.0-preview.79
- Fix: Resolved an HTTP 404 error that occurred in the vision filter addon when no filter was selected, caused by an invalid CSS file path reference.

To see all the change logs, please visit the following URL.
- https://github.com/jsakamoto/BlazingStory/blob/main/RELEASE-NOTES.txt