Repolode
Submit
dotnet

dotnet/eShop

A reference .NET 10 e-commerce application built with services-based architecture and .NET Aspire, for studying how a multi-service shop is structured.

View on GitHub
Stars
10,975
Forks
3,882
Open issues
126
Last commit
5 days ago

What is it?

eShop is a reference e-commerce website written in C# on .NET 10. It is split into several services and orchestrated with .NET Aspire, so the whole system, including its backing infrastructure, starts from a single AppHost project.

Running it locally requires a .NET 10 SDK, the Aspire CLI, and an OCI-compatible container runtime such as Docker Desktop or Podman. The sample includes a catalog of fictional products, a web front end, and client apps built with .NET MAUI. An optional AI chatbot can be enabled through Microsoft Foundry, which Aspire provisions during local development.

The project also documents deploying to Azure Container Apps with the Aspire CLI. The sample deploys PostgreSQL, Redis, and RabbitMQ as containers there, and the README notes this setup is meant for evaluation rather than production data.

Key features

  • 01Multi-service e-commerce architecture orchestrated by .NET Aspire
  • 02Runs locally from one AppHost with Docker or Podman as the container runtime
  • 03Includes a product catalog, web front end, and .NET MAUI client apps
  • 04Optional AI chatbot backed by Microsoft Foundry models
  • 05Supports deployment to Azure Container Apps through the Aspire CLI

Use cases

  • Learning how to structure a multi-service .NET web application
  • Exploring .NET Aspire for local orchestration and deployment
  • Using as a starting point for a C# e-commerce prototype
  • Testing browser journeys with Playwright against a full stack

Quick start

  1. 1

    Install a .NET 10 SDK that satisfies global.json

  2. 2

    Install and start a container runtime such as Docker Desktop

  3. 3

    Clone the repository

    git clone https://github.com/dotnet/eShop.git
  4. 4

    From the repository root, start the AppHost

    aspire run

Things to know

  • Requires a running OCI-compatible container runtime such as Docker or Podman.
  • Requires the Aspire CLI and a .NET 10 SDK.
  • The optional AI chatbot needs an Azure subscription and provisions Microsoft Foundry resources.
  • The Azure deployment is intended for evaluation and demos, not production data.

In collections

Microservice frameworks & service infrastructure

Topics

#dotnet#csharp#e-commerce#microservices#aspire#reference-architecture#azure

FAQ

What is eShop?
A reference .NET 10 e-commerce application built with services-based architecture and .NET Aspire, for studying how a multi-service shop is structured. eShop is a reference e-commerce website written in C# on .NET 10. It is split into several services and orchestrated with .NET Aspire, so the whole system, including its backing infrastructure, starts from a single AppHost project.
Is eShop free to use? What license does it have?
eShop is open source under the MIT license. Check the license terms before using it in commercial products.
Is eShop still maintained?
Actively maintained. The last commit to eShop was on Oct 19, 2026.
What can I use eShop for?
Learning how to structure a multi-service .NET web application Exploring .NET Aspire for local orchestration and deployment Using as a starting point for a C# e-commerce prototype Testing browser journeys with Playwright against a full stack
How do I install eShop?
Install a .NET 10 SDK that satisfies global.json Install and start a container runtime such as Docker Desktop Clone the repository: git clone https://github.com/dotnet/eShop.git From the repository root, start the AppHost: aspire run
Where can I get eShop?
The source code and installation instructions are on GitHub: https://github.com/dotnet/eShop

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects