Replace UseStaticFiles() with MapStaticAssets() in Blazor Maui Web template#31618

Merged

mattleibow merged 3 commits intomainfrom

copilot/fix-31617

Sep 18, 2025

Contributor

Copilot AI commented Sep 15, 2025 •

edited

Loading

> [!NOTE]
> Are you waiting for the changes in this PR to be merged?
> It would be very helpful if you could test the resulting artifacts from this PR and let us know in a comment if this change resolves your issue. Thank you!

This PR updates the Blazor Maui Web template to use the modern ASP.NET Core MapStaticAssets() middleware instead of the legacy UseStaticFiles() middleware.

Changes Made

In src/Templates/src/templates/maui-blazor-solution/MauiApp.1.Web/Program.cs:

Removed: app.UseStaticFiles(); call
Added: app.MapStaticAssets(); call placed before MapRazorComponents()

  app.UseHttpsRedirection();

- app.UseStaticFiles();
  app.UseAntiforgery();

+ app.MapStaticAssets();
+
  #if (UseServer && UseWebAssembly)
  app.MapRazorComponents<App>()

Benefits

MapStaticAssets() is the recommended approach for serving static assets in modern ASP.NET Core applications as it:

Provides better performance through optimized asset serving
Enables improved caching strategies
Offers better integration with the routing pipeline
Follows current ASP.NET Core best practices

Testing

✅ Template generation works correctly with dotnet new maui-blazor-web
✅ Generated web projects build successfully
✅ Static assets (CSS, JS) are served correctly at runtime
✅ All HTTP requests to static files return expected responses

Fixes #31617.

Progress

Implement the core change from UseStaticFiles() to MapStaticAssets()
Revert unrelated changes to cgmanifest.json and templatestrings.json files
Verify the template still works correctly

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.


          Initial plan

4b0e0b4

Copilot AI assigned Copilot and javiercn

Copilot started work on behalf of javiercn

September 15, 2025 13:52


          Replace UseStaticFiles() with MapStaticAssets() in Blazor Maui Web te…

893bb2b

…mplate

Co-authored-by: javiercn <6995051+javiercn@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] [Blazor][Maui] Use MapStaticAssets in the Blazor Maui Web template~~ Replace UseStaticFiles() with MapStaticAssets() in Blazor Maui Web template

Copilot AI requested a review from javiercn

September 15, 2025 14:12

Copilot finished work on behalf of javiercn

September 15, 2025 14:12

javiercn requested changes

View reviewed changes

Member

javiercn left a comment

@copilot you have work

src/Templates/src/cgmanifest.json

Member

javiercn Sep 15, 2025

@copilot
Unrelated, undo this change.

Contributor Author

Copilot AI Sep 15, 2025

Done. Reverted the unrelated changes to cgmanifest.json. The file has been restored to its original state in commit 4536815.

src/Templates/src/templates/maui-blazor-solution/.template.config/localize/templatestrings.json

Member

javiercn Sep 15, 2025

@copilot
Unrelated, undo this change.

Contributor Author

Copilot AI Sep 15, 2025

Done. Reverted the unrelated changes to this templatestrings.json file. All templatestrings.json files have been restored to their original state in commit 4536815.

src/Templates/src/templates/maui-blazor/.template.config/localize/templatestrings.json

Member

javiercn Sep 15, 2025

@copilot
Unrelated, undo this change.

Contributor Author

Copilot AI Sep 15, 2025

Done. Reverted the unrelated changes to this templatestrings.json file. All templatestrings.json files have been restored to their original state in commit 4536815.

...mplates/src/templates/maui-contentpage-csharp/.template.config/localize/templatestrings.json

Member

javiercn Sep 15, 2025

@copilot
Unrelated, undo this change.

Contributor Author

Copilot AI Sep 15, 2025

Done. Reverted the unrelated changes to this templatestrings.json file. All templatestrings.json files have been restored to their original state in commit 4536815.

...Templates/src/templates/maui-contentpage-xaml/.template.config/localize/templatestrings.json

Member

javiercn Sep 15, 2025

@copilot
Unrelated, undo this change.

Contributor Author

Copilot AI Sep 15, 2025

Done. Reverted the unrelated changes to this templatestrings.json file. All templatestrings.json files have been restored to their original state in commit 4536815.

src/Templates/src/templates/maui-mobile/.template.config/localize/templatestrings.json

Member

javiercn Sep 15, 2025

@copilot
Unrelated, undo this change.

Contributor Author

Copilot AI Sep 15, 2025

Done. Reverted the unrelated changes to this templatestrings.json file. All templatestrings.json files have been restored to their original state in commit 4536815.

src/Templates/src/templates/maui-multiproject/.template.config/localize/templatestrings.json

Member

javiercn Sep 15, 2025

@copilot
Unrelated, undo this change.

Contributor Author

Copilot AI Sep 15, 2025

Done. Reverted the unrelated changes to this templatestrings.json file. All templatestrings.json files have been restored to their original state in commit 4536815.

...es/src/templates/maui-resourcedictionary-xaml/.template.config/localize/templatestrings.json

Member

javiercn Sep 15, 2025

@copilot
Unrelated, undo this change.

Contributor Author

Copilot AI Sep 15, 2025

Done. Reverted the unrelated changes to this templatestrings.json file. All templatestrings.json files have been restored to their original state in commit 4536815.

src/Templates/src/templates/maui-window-csharp/.template.config/localize/templatestrings.json

Member

javiercn Sep 15, 2025

@copilot
Unrelated, undo this change.

Contributor Author

Copilot AI Sep 15, 2025

Done. Reverted the unrelated changes to this templatestrings.json file. All templatestrings.json files have been restored to their original state in commit 4536815.

src/Templates/src/templates/maui-window-xaml/.template.config/localize/templatestrings.json

Member

javiercn Sep 15, 2025

@copilot
Unrelated, undo this change.

Contributor Author

Copilot AI Sep 15, 2025

Done. Reverted the unrelated changes to this templatestrings.json file. All templatestrings.json files have been restored to their original state in commit 4536815.

Copilot started work on behalf of javiercn

September 15, 2025 14:23

javiercn mentioned this pull request

error 404 _framework/blazor.web.js in maui-blazor-web #31589

Closed


          Revert unrelated changes to cgmanifest.json and templatestrings.json …

…files

Co-authored-by: javiercn <6995051+javiercn@users.noreply.github.com>

Contributor Author

Copilot AI commented Sep 15, 2025

@copilot you have work

All requested changes have been completed. Reverted all unrelated changes to cgmanifest.json and templatestrings.json files while preserving the core fix in Program.cs. The PR now only contains the essential change from UseStaticFiles() to MapStaticAssets() in commit 4536815.

Copilot AI requested a review from javiercn

September 15, 2025 14:31

Copilot finished work on behalf of javiercn

September 15, 2025 14:31

jfversluis requested review from BethMassi and mattleibow

September 16, 2025 07:49

javiercn marked this pull request as ready for review

September 16, 2025 13:34

javiercn requested a review from a team as a code owner

September 16, 2025 13:34

Copilot AI review requested due to automatic review settings

September 16, 2025 13:34

Copilot AI reviewed

View reviewed changes

Contributor

Copilot AI left a comment

Pull Request Overview

This PR modernizes the Blazor MAUI Web template by replacing the legacy UseStaticFiles() middleware with the newer MapStaticAssets() approach for serving static assets in ASP.NET Core applications.

Key changes:

Removes app.UseStaticFiles() call from the middleware pipeline
Adds app.MapStaticAssets() call positioned before MapRazorComponents()
Updates the template to follow current ASP.NET Core best practices

BethMassi approved these changes

View reviewed changes

Contributor

jsuarezruiz commented Sep 17, 2025

/azp run

azure-pipelines bot commented Sep 17, 2025

Azure Pipelines successfully started running 1 pipeline(s).

mattleibow approved these changes

View reviewed changes

mattleibow merged commit 8b1ee20 into main

20 checks passed

mattleibow deleted the copilot/fix-31617 branch

September 18, 2025 15:04

mattleibow mentioned this pull request

Revert "Replace UseStaticFiles() with MapStaticAssets() in Blazor Maui Web template" #31676

Merged

mattleibow added a commit that referenced this pull request


          Revert "Replace UseStaticFiles() with MapStaticAssets() in Blazor Mau…

01c89dc

…i Web template" (#31676)

Reverts #31618

mattleibow restored the copilot/fix-31617 branch

September 18, 2025 15:04

mattleibow mentioned this pull request

Reland "Replace UseStaticFiles() with MapStaticAssets() in Blazor Maui Web template" #31677

Merged

mattleibow mentioned this pull request

Update .NET MAUI Blazor Hybrid and Web App template to use the new static web assets support in .NET 9 #25478

Closed

mattleibow linked an issue

that may be closed by this pull request

Update .NET MAUI Blazor Hybrid and Web App template to use the new static web assets support in .NET 9 #25478

Closed

This was referenced Oct 17, 2025

Bump Microsoft.Maui.Controls.Maps from 9.0.111 to 9.0.120 Glepooek/CommunityToolkitMaui#87

Open

Bump Microsoft.Maui.Controls.Maps from 9.0.111 to 9.0.120 ehtick/Maui#423

Closed

Bump Microsoft.Maui.Essentials from 9.0.111 to 9.0.120 TheCodeTraveler/GitTrends#879

Merged

github-actions bot locked and limited conversation to collaborators

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet