The Realm Archicture - .NET Template

Installation

$ dotnet new install RealmDigital.Architecture

Usage

$ dotnet new realm-architecture -o [YOUR_PROJECT_NAME]

Use what you want, delete what you don't

Includes a fully featured application (.NET 7 Web API + Next.js UI)

Technology

• .NET 7
• EF Core 7
• PostgreSQL
• MediatR
• Source Generators
• Docker
• NextJS
• Identity
• Terraform

Preamble

1. Write a business operation as a MediatR Query/Command

[Authorize(Roles = nameof(Role.Admin))] public sealed record GetUsersQuery : IQuery<List<CrudContracts.User>> { public sealed class Handler : IQueryHandler<GetUsersQuery, List<CrudContracts.User>> { private readonly ApplicationContext _applicationContext; private readonly IMapper _mapper; public Handler(ApplicationContext applicationContext, IMapper mapper) { _applicationContext = applicationContext; _mapper = mapper; } public async Task<ErrorOr<List<CrudContracts.User>>> Handle(GetUsersQuery query, CancellationToken cancellationToken) { var users = await _applicationContext.Users.OrderByDescending(x => x.Id).ToListAsync(cancellationToken); return _mapper.Map<List<CrudContracts.User>>(users); } } }

2. Magic happens *

3. Use the query/mutation in your React (or Vue) application

const getUsersQuery = UsersQueries.useGetUsersQuery() if (getUsersQuery.isError) return <div>Failed to load</div> if (getUsersQuery.isLoading) return <div>Loading...</div> return ( <ul> {users.map(user => ( <li>{user.name} ))} </ul> )

4. Profit?!?!

* The magic is 3 parts

1. Source generators automatically create Web API Controllers for each Query/Command - automatically, on build
2. Nswag generates an OpenAPI specificiation document for these controllers - automatically, on build
3. A .NET console application generates an Axios based TypeScript API client along with TanStack Query queries & mutations - manually, by running: