dotnet-architecture/eshoponweb

★ 10,661C#Audience · developerComplexity · 3/5Setup · moderate

Mindmap

mindmap
  root((eShopOnWeb))
    What it does
      Sample e-commerce
      Architecture teaching
      Microsoft reference
    Tech Stack
      ASP.NET Core C#
      Blazor admin panel
      SQL Server Azure
    Use Cases
      Learn clean architecture
      .NET project template
      Azure deployment
    Extras
      Free ebook included
      Dev container support
      In-memory DB option

mindmap root((eShopOnWeb)) What it does Sample e-commerce Architecture teaching Microsoft reference Tech Stack ASP.NET Core C# Blazor admin panel SQL Server Azure Use Cases Learn clean architecture .NET project template Azure deployment Extras Free ebook included Dev container support In-memory DB option

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Study clean architecture and domain-driven design patterns in a real runnable ASP.NET Core project

USE CASE 2

Use the codebase as a starting template for a well-structured traditional .NET web application

USE CASE 3

Deploy a fully working .NET e-commerce app to Azure with a single azd up command to learn Azure deployment

USE CASE 4

Read alongside the free Microsoft ebook to see every architectural pattern applied in working code

Tech stack

C#ASP.NET CoreBlazorSQL ServerAzure

Getting it running

Difficulty · moderate Time to first run · 30min

Needs both the main web project and a separate API project running simultaneously for the Blazor admin panel to work.

In plain English

eShopOnWeb is a sample online store application built with ASP.NET Core, created by Microsoft to demonstrate how to structure a traditional web application. It is not intended to be a production e-commerce system, but rather a teaching example that accompanies a free ebook called Architecting Modern Web Applications with ASP.NET Core and Azure. The codebase shows how to apply common architectural patterns like clean architecture and domain-driven design in a real, runnable project rather than abstract diagrams. The application is a single deployable unit, meaning the entire site runs as one process. This is intentional: the repo is explicitly positioned as the simpler single-process alternative to a companion project called eShopOnContainers, which breaks the same store into many small services. eShopOnWeb shows what a well-organized traditional web app looks like before any microservices splitting happens. Functionally the store has a product catalog, a shopping cart, an order flow, and an admin section built in Blazor WebAssembly. It connects to SQL Server by default but can run with an in-memory database for quick local testing. Running it fully requires starting both the main web project and a separate API project that the Blazor admin panel calls. The project can be run locally with standard .NET tooling, inside a dev container, or deployed to Azure using the Azure Developer CLI with a single azd up command. The README covers all three paths with step-by-step instructions including database migration commands. As of the time of writing, active Microsoft development has moved to a newer repository at github.com/dotnet/eShop. A community-maintained fork also exists at NimblePros/eShopOnWeb. This repository remains publicly available and the ebook it accompanies is still freely downloadable, but new features will appear in the successor repos rather than here.

Copy-paste prompts

Prompt 1

Help me understand how eShopOnWeb separates its domain logic, application layer, and infrastructure layer using clean architecture principles.

Prompt 2

Show me how eShopOnWeb implements the repository pattern in C# so I can apply the same structure to my own ASP.NET Core app.

Prompt 3

Walk me through deploying eShopOnWeb to Azure using the Azure Developer CLI including any configuration I need to set first.

Prompt 4

I want to add a new product filter feature to eShopOnWeb, help me understand which files to edit following its clean architecture structure.

Open on GitHub → Explain another repo

← dotnet-architecture on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.