TopGit
GitHub Repo Review

eShopOnContainers: .NET Microservices Reference

dotnet-architecture/eShopOnContainers
ETopGit review image for dotnet-architecture/eShopOnContainers
Review by Topgit.dev for dotnet-architecture/eShopOnContainers, with GitHub repository stats and README context.
Quick verdict

eShopOnContainers is worth studying only as a historical snapshot: Microsoft archived it in November 2023 and moved active development to dotnet/eShop, freezing this repo's patterns at .NET 7. If you want DDD and container-based microservices laid out end-to-end in one .NET codebase, it still does that job — just don't treat its 'dev' branch as current guidance for a live project.

Stars
★ 24.3k
Forks
⑂ 10.1k
Contributors
👥 217
Language
C#
License
See repository
Topic
Developer Tools
Updated
Nov 2023
Homepage
GitHub

What eShopOnContainers demonstrates

eShopOnContainers is a Microsoft reference sample for building a .NET e-commerce backend as independently deployable microservices using Domain-Driven Design, each in its own Docker container. It pairs a SPA web client with a Xamarin mobile client against that backend, and documents deployment to Azure Kubernetes Service on Linux, Windows, and macOS. The project moved to dotnet/eShop in November 2023. This repo is now archived.

Architecture patterns and technologies covered

  • ✓Domain-Driven Design applied across separate microservices rather than one monolithic bounded context.
  • ✓Each service packaged as its own Docker container, matching the repo's docker and windowscontainers topics.
  • ✓.NET 7 backend code that runs on Linux, Windows, and macOS from the same codebase.
  • ✓A SPA web client and a Xamarin mobile client both calling the same backend services.
  • ✓Documented deployment path to Azure Kubernetes Service for container orchestration.
  • ✓Support for Visual Studio, VS for Mac, VS Code, and CLI workflows via the docker CLI and dotnet CLI.
How this repository's GitHub stars have grown over time. Source: star-history.com.View the star history ↗

Strengths

  • ✓Ties DDD, containerization, multi-platform targeting, and multi-client (web plus mobile) integration together in one codebase instead of separate toy demos.
  • ✓Backed by Microsoft, so the architecture follows documented .NET guidance rather than one developer's personal opinion.
  • ✓The 'dev' branch keeps the pre-migration code browsable even though the main branch is now a read-only archive.

Known limitations of this reference architecture

  • △Read-only archive since November 2023 — nothing here reflects .NET tooling or package versions released after that date.
  • △Frozen at .NET 7, which is already older than whatever ships in dotnet/eShop today.
  • △The 'dev' branch holds the old code but comes with no migration guide or changelog explaining what changed.

Where to find the active eShop project

dotnet/eShop — the actively maintained continuation of this same sample, where new .NET microservices patterns actually land now.The 'dev' branch of this same eShopOnContainers repo, if you specifically need the pre-migration .NET 7 code rather than a live project.

Frequently asked questions

Where did eShopOnContainers move to?

eShopOnContainers moved to the dotnet/eShop repository on GitHub as of November 2023, and Microsoft continues active development of the sample there.

Is eShopOnContainers production-ready?

eShopOnContainers was built and documented as a learning sample, not a production template, and the repository is now a read-only archive — for current production-style guidance, dotnet/eShop is the maintained version to reference instead.

What .NET version does eShopOnContainers use?

eShopOnContainers is powered by .NET 7 according to the repository description, and that version is frozen since the repo no longer receives updates.

Does eShopOnContainers support Kubernetes deployment?

eShopOnContainers documents deployment to Azure Kubernetes Service as part of its container-based architecture, alongside plain Docker container support.

What programming languages are used in eShopOnContainers?

eShopOnContainers is written primarily in C#, which is GitHub's listed language for the repository, matching its .NET and ASP.NET Core based services.

Can I still access the old eShopOnContainers code after the migration?

The old eShopOnContainers code that predates the November 2023 migration is still available — it lives in this repository's 'dev' branch, separate from the now-archived main branch.

Best use cases

  • •Learning how to split an e-commerce domain into DDD-bounded microservices instead of one monolith.
  • •Studying a worked example that pairs a containerized .NET backend with both a web SPA and a Xamarin mobile client.
  • •Comparing this .NET 7 architecture against the actively maintained dotnet/eShop before starting a new project.

Who should try it — and who should skip

Try eShopOnContainers if you're learning DDD-based microservices in .NET and want one worked example that ties together containerization, a SPA front end, and a Xamarin mobile client instead of reading about each piece separately. Skip it if you need current guidance for a real project — go straight to dotnet/eShop instead, since this repo stopped receiving updates in November 2023 and its .NET 7 baseline is already dated.

Related repositories

Source & attribution

Facts sourced from the dotnet-architecture/eShopOnContainers GitHub repository (README and repository metadata).

GitHub data · last synced Aug 15, 2026Reviewed by Henry
← Back to TopGit

Is eShopOnContainers worth your time?

ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of eShopOnContainers.

GitHub