First Class Blazor WASM Template

We’ve decided to make NetCoreTemplates/blazor-wasm a first class supported template that can be created with:

$ x new blazor-wasm ProjectName

It contains all our recommendations including a new recommended way for creating a Blazor Client with:

    builder.Configuration["ApiBaseUrl"] ?? builder.HostEnvironment.BaseAddress);

Where it registers a JsonApiClient (subclass of JsonHttpClient) using the recommended IHttpClientFactory registration APIs.

This makes usage of our new ServiceStack.Blazor package containing all ServiceStack functionality specifically for Blazor WASM apps which currently contains the API Service Client as well as the <ErrorSummary> and <ErrorField> components used for form validation binding used throughout the App. We’ll look to adding more useful components in future.

Blazor Template Features

It includes a number of encapsulated functionality to show how we’d implement different features:

Links to source code used in each feature is at the bottom of each page

We’ve purposefully left out client validation & navigation hiding in a lot of places to demonstrate the server error & validation binding.

Markdown Support

We’ve also added markdown support which is best suited for maintaining docs & static content and included 2 docs for this template, the first explaining the included GitHub Actions which supports SSH deploying the CI built Docker image to a vanilla Linux Server. Basically after a 1-time setup on your remote Linux Server you can deploy each App by just filling in these GitHub Action Secrets.

And if you have many Apps (Like we do in NetCoreTemplates) each App only needs to define a DEPLOY_API secret specifying the DNS domain name for your server and optionally (but recommended) DEPLOY_CDN for the domain name your Repos GitHub Pages should use to host the Blazor WASM Client UI Static Assets.

The second doc just lists the benefits of using a CDN and how cheap the TCO is for hosting Apps.

Live Demo

The blazor-wasm template uses the GitHub Actions to deploy the templates Live Demo:

As we can see the potential for using Blazor WASM for internal LOB Apps this will be a first-class template we’ll continue to invest in and support going forward. Happy to answer any questions of feedback about the template.