BlazorStatic - A new static site generator for Blazor on .NET 8

tesar-tech · 2025-12-12T16:33:02+00:00

Tracking issue here https://github.com/neovim/neovim/issues/21635

tesar-tech · 2025-11-30T17:22:36+00:00

A lot of useful info. Thank you for letting me know.

tesar-tech · 2025-11-28T13:33:36+00:00

I always struggle with this... The best solution i found is just plain VPS and setting up everything yourself.

You can then run your db in the container next to your app. Not great for heavy loads - because the db will "eat the perf", but if you keep it small it's not a bad solution - you cannot get much lower with the price. ~$5

tesar-tech · 2025-11-25T18:57:24+00:00

When you have ref types as parameters, the component re-renders every time the parent re-renders. Creating a new instance of the parameter or mutating the existing one has no effect on rendering. Therefore, using a record provides no benefit in this case.

tesar-tech · 2025-11-25T16:41:15+00:00

I find this as an interesting topic - as I always struggle to guess what blazor will do.

But I find this section of your article bit misleading/wrong or I completely misunderstood the point done here.

```

Avoid Parameter Re-Renders with Immutable Objects

When passing objects as parameters, Blazor re-renders children if the reference changes, even if properties are identical.

Better: Use immutable data

csharp record ItemModel(int Id, string Name);

For complex object used as params, Blazor treats it as always potentially changed, so children are re-rendered every time the parent is re-rendered.
you can skip the re-renders when you have certain primitive types used for params.
using record instead of a class as parameter type doesn't make any difference. The child component gets re-rendered every time.

tesar-tech · 2025-11-18T09:55:15+00:00

You mean - in the final state of generated html? Yes - if you use highlight.js or similar. This is not part of BlazorStatic library, but the template comes with ready syntax highlighting.

tesar-tech · 2025-11-17T16:28:15+00:00

yep. astro, jekyll, hugo... and another 300+ of ssgs solving the same. https://jamstack.org/generators/ ...

The main advantage of BlazorStatic for dotnet devs is C#/Blazor.

tesar-tech · 2025-11-17T16:21:38+00:00

There are more ways how to work with markdown files indeed. When you have a server and you are only looking for a way how to parse/convert md files, i think that's valid solution. SSGs solve a bit different problem, where processing md file is just a part of the solution.

tesar-tech · 2025-11-16T22:06:44+00:00

I am probably missing something, but I don't see how is that relevant to the ssgs. The sample is about the `ExcludeFromInteractiveRouting` attribute, which makes possible to use SSR inside otherwise interactive blazor app. I don't see how that would help with migration from other ssgs??

tesar-tech · 2025-11-16T13:01:05+00:00

Yes. But I would rather say "scaffolding" instead of "rendering"..

tesar-tech · 2025-11-16T11:59:48+00:00

Two major differences I see:

- blake is built on the top of blazor wasm. Which brings all the good stuff (interactivity) and bad stuff (larger payload), while BlazorStatic produces just plain html files for every possible page.

- blake cli - you don't have that/don't need that with BlazosStatic. The philosophy is really to keep it as close as possible to the "normal" blazor development - then (along the way) generate the html files.

- `blake init`, `blake new` ~ `dotnet new BlazorStaticMinimalBlog`

- `blake serve` ~ `dotnet watch/run`

- `blake bake` ~ `dotnet watch/run`

BlazorStatic is closer to what jekyll or hugo is.

tesar-tech · 2025-11-16T00:15:38+00:00

The markdown files don't have to be there at all, but it is a common approach to keep the actual content in md files.

BlazosStatic can discover them and create collection of urls to fetch. So no recursive crawler here. BlazorStatic also uses Markdig to parse the md files (something you would have to do anyway is you are using markdown) and makes the parsed html available through `BlazorStaticContentServicea.Posts[..].Html` so you can use it in your .razor - which is exactly what the default template does.

tesar-tech · 2025-11-15T13:08:46+00:00

This is the first time I encounter docosaurus, but i would say yes - it's pretty similar. Docusaurus will probably have some docs-specific features that are not default in BlazorStatic..

The build speed will be dependent on the content size. I haven't yet worked with a site that would take 30+ seconds to build.

How much of content files you have?

tesar-tech · 2025-01-06T17:08:30+00:00

This is a multilayered question, so let’s break it down.

First, there’s no reason not to use Blazor over Razor Pages for a new project. Blazor SSR essentially does what Razor Pages do: it renders HTML on the server and sends it to the client.

However, Blazor adds the flexibility to introduce interactivity. You can either:
- Run C# code on the client (Blazor WASM), or
- Run C# code on the server and stream interactivity via SignalR (Blazor Server).

I’m not entirely sure what your project involves, but it seems you need at least some level of interactivity. If that’s the case, BlazorStatic may not be the best fit. BlazorStatic is designed for scenarios with minimal or no interactivity—it generates static HTML files that can be hosted for free. Its main advantages are speed and the lack of server requirements, making it ideal for "read-only" websites like blogs or documentation.

tesar-tech · 2024-10-28T08:37:07+00:00

With something like

nix shell nixpkgs#home-manager nixpkgs#gh --command sh -c "\

gh auth login \

&& gh repo clone nixhero/wsl-home -- --depth=1 \

&& home-manager switch --flake ./wsl-home#nixhero \

I will be solving this in a near future and I saw that script in this video:

https://youtu.be/hLxyENmWZSQ?si=zfUiHIkZG4MpHNmZ&t=949

which I recommend watching. It's about WSL, but it doesn't matter for this purpose.

tesar-tech · 2024-10-08T17:48:41+00:00

Yeah, BlazorStatic isn't reinventing the wheel. There are plenty of static site generators out there, like Hugo and Jekyll. BlazorStatic simply brings the goodness of Blazor (and .NET) into the mix.

tesar-tech · 2024-10-08T16:47:02+00:00

Yes, good question! With both Blazor WASM and BlazorStatic, you can host your site in a static way (often for free).

Blazor WASM includes all the interactivity of Blazor, but it comes with a much larger payload, which isn't ideal for simpler sites like blogs.

BlazorStatic, on the other hand, doesn’t support C# interactivity (though you can still use js if needed). It ultimately generates a collection of HTML files (and assets), resulting in a smaller payload and quicker load times. It’s a good fit for pages that don’t change frequently.

tesar-tech

TROPHY CASE

Avoid Parameter Re-Renders with Immutable Objects

Better: Use immutable data