eShop

eShop is a reference application from Microsoft that shows how to build an e-commerce website using .NET, Microsoft's software development platform. It is called a reference application because its purpose is educational: it demonstrates patterns and practices that the .NET team recommends, rather than being a product you would use directly in production.

The application is structured as a set of services that communicate with each other, which is sometimes called a services-based or microservices architecture. Rather than one large program that does everything, it splits the work across separate pieces: a catalog of products, a shopping basket, ordering, payment, and a web frontend that customers see. The architecture diagram in the README shows how these pieces connect.

The project is built on top of .NET Aspire, a Microsoft framework designed to make it easier to build and run these kinds of multi-part applications locally and in the cloud. Aspire handles a lot of the wiring between services and provides a dashboard you can open in a browser to see what is running.

Running it locally requires Docker, which is a tool for running software in isolated containers, and either Visual Studio (a Microsoft development environment for Windows) or the .NET SDK (available on Mac, Linux, and Windows). The README walks through setup for each option. Once running, you get a working online store with a product catalog populated with fictional items whose names and images were generated by AI.

For deploying to cloud infrastructure, the project includes support for the Azure Developer CLI, which automates the process of creating the necessary cloud resources and deploying the application. The product catalog, descriptions, and images in the sample data are entirely fictional.