Knowledge Base

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Deploy Blazor WebAssembly to GitHub Pages ======

Create a Blazor webassembly project, e.g.:

<code bash>
dotnet new blazorwasm -o BlazorWasmTest
</code>

Publish:

<code bash>
dotnet publish -c Release -o output
</code>

The base tag in output/wwwroot/index.html needs to be updated. Change this tag:

<code html>
<base href="/" />
</code>

To this:

<code html>
<base href="https://root-of-github-page/" />
</code>

For example, if your GitHub username is ''johndoe'', and your repo name is ''my-cool-repo'', then your GitHub page URL tag will be this:

<code html>
<base href="https://johndoe.github.io/my-cool-repo/" />
</code>

If you want to simplify this, e.g., in a Makefile, use these commands in a Makefile target:

<WRAP prewrap>
<code bash>
dotnet publish -c Release -o output

cd output/wwwroot; sed -i 's|<base href="/" />|<base href="https://johndoe.github.io/my-cool-repo/" />|' index.html
</code>
</WRAP>

In the repo, enable GitHub pages and add a Static HTML GitHub action as the deployment method. Update the static.yml file for the action as follows: In jobs, deploy, steps, with, path, change ''path: '.''' to ''path: 'output/wwwroot'''.

When you commit, the contents of output/wwwroot will automatically be deployed.

{{tag>dotnet}}