Skip to content

Latest commit

 

History

History
41 lines (35 loc) · 2.75 KB

README.md

File metadata and controls

41 lines (35 loc) · 2.75 KB
Raw

Blazor with API Starter! 🟪 (.NET 7) 🟪

This is a starter project / template which consists of a Blazor frontend and a ASP.NET Core backend. The Blazor app in this template is served from the ASP.NET Core Server.

When running this solution, please set the Server project as Startup project if you're running this in Visual Studio or if running this via VS Code please cd into the Server Project folder and run dotnet run in your cmd/powershell/terminal of choice

BTW! Feel absolutely free to fork/clone this repo and remix it to create your own starter ❤️ e.g. like swapping out EF Core for Dapper or any other ORM or Data Access Library you prefer.

What you need to run this starter project?

  • The NET 7 SDK (https://dotnet.microsoft.com/en-us/download/dotnet/7.0)
  • VS Code or Visual Studio 2022 (Current Latest, feel free to use preview however i've only tested this on current)
  • Should be able to run on Windows/Mac/Linux (i haven't tested this, just running off of .NET 7's ability to be cross platform), if not please let me know as there might be a setting or silly config i'm missing.

At a glance this project contains:

  • A Blazor Client (containing the default blazor project pieces minus the WeatherAPI bits)
  • ASP.NET CORE Server (API)
  • A Shared Project (for sharing code and services between the frontend and backend)
  • Test projects Client, Server and Shared

So what's configured?

  • All projects are targeting .NET 7
  • All test projects are configured to use XUnit and contain Moq for mocking dependencies.
  • The Blazor Test Project has Bunit for Testing pages and components
  • The Server Test Project contains a Fixture which creates a In-memory Entity Framework Core 7 Database (see example in the server test's InMemoryDbTests.cs file), this will enable you to test without using a physical DB!
  • The Client Project has an example of A Typed Http-Client to call to the Server which can be injected into your components and pages.
  • The Server Project has examples of:
    • A Controller
    • A Service
    • A Middleware
    • A DbContext (EF Core 7) which is tied to a SQLite db called Example.db (this is to have a working db out of the box feel free to retarget to any that EF-Core supports!)
    • Usage of Automapper

Technologies / Libs included at a glance.

  • Entity Framework Core 7
  • Moq
  • Automapper
  • FluentValidation & Blazored.FluentValidation (which is so good i've even contributed :D, FluentValidation is my preference for swapping out the standard System.ComponentModel.DataAnnotations decorators)
  • Bunit
  • Xunit
  • System.Text.Json
  • Microsoft.Extensions.Http (for configuring HttpClient and HttpMessageHandler in IHttpClientFactory, for me this provides the nice services.AddHttpClient method for adding HttpClients to DI i use in Client/Program.cs startup)