RossWright.MetalCore.Blazor 2026.1.1

Ross Wright's Metal Core Blazor Library

Copyright (c) 2023-2026 Pross Co.

Table of Contents

• Services
  • IBrowserLocalStorage
  • IJsScriptLoaderService
• IServiceCollection Extensions
• App Builder Fluent Syntax
  • WebAssemblyHostBuilder
• Installation
• See Also
• License

Services

IBrowserLocalStorage

IBrowserLocalStorage provides async access to the browser's localStorage API via JavaScript interop. All methods return ValueTask so they integrate naturally with await in Razor components.

// Store and retrieve a value
await localStorage.Set("theme", "dark");
var theme = await localStorage.Get("theme");

// Remove one key or clear everything
await localStorage.Remove("theme");
await localStorage.Clear();

IJsScriptLoaderService

IJsScriptLoaderService lazily loads external JavaScript files via interop, ensuring each script is injected only once per application lifetime.

// Load a script; subsequent calls for the same path are no-ops
await jsLoader.EnsureLoaded("/js/chart.min.js", "Chart");

// Optionally supply a hash for cache-busting
await jsLoader.EnsureLoaded("/js/chart.min.js", "Chart", fileHash: "abc123");

IServiceCollection Extensions

builder.Services.AddBrowserLocalStorage();
builder.Services.AddJsScriptLoader();

App Builder Fluent Syntax

MetalCore provides extension methods on WebAssemblyHostBuilder and WebAssemblyHost that enable a single fluent chain from CreateDefault(args) through to RunAsync(), eliminating the intermediate variable assignments that standard WASM startup requires.

RunAsync(butFirst:) accepts an async delegate that runs after the host is built but before it starts. This is the right place to pre-load services — for example, fetching content or initializing state — before the first Blazor component render.

var app = WebAssemblyHostBuilder
    .CreateDefault(args)
    .AddRootComponents(_ => _.Add<App>("#app"))
    .AddMetalInjection(_ => _.ScanThisAssembly())
    .AddServices(_ => _.AddMudServices())
    .Build()
    .RunAsync(butFirst: async host => {
        await host.Services
            .GetRequiredService<IContentService>()
            .Initialize();
    });

WebAssemblyHostBuilder

Installation

dotnet add package RossWright.MetalCore.Blazor

Or add directly to your project file:

<PackageReference Include="RossWright.MetalCore.Blazor" Version="*" />

Note: IBrowserLocalStorage and IJsScriptLoaderService require a live browser JavaScript context. They are not suitable for server-side Blazor or SSR rendering modes.

See Also

License

All Ross Wright Metal Libraries including this one are licensed under Apache License 2.0 with Commons Clause.

You are free to:

• Use the libraries in any project (personal or commercial)
• Modify them
• Include them in products or services you sell

You may not:

• Sell the libraries themselves (or any product/service whose primary value comes from the libraries)
• Repackage them with minimal changes and sell them as your own standalone product

Full legal text: LICENSE.md