eShop Reference Application - "Northern Mountains"

A reference .NET application implementing an eCommerce web site using a services-based architecture.

Getting Started

Prerequisites

Clone the eShop repository: https://github.com/dotnet/eshopOnAzure
(Windows only) Install Visual Studio. Visual Studio contains tooling support for .NET Aspire that you will want to have. Visual Studio 2022 version 17.9 Preview.
- During installation, ensure that the following are selected:
  - ASP.NET and web development workload.
  - .NET Aspire SDK component in Individual components.
Install & start Docker Desktop: https://docs.docker.com/engine/install/
Install the latest .NET 8 SDK

Running the solution

Running eShop requires a dependency on .NET Aspire. To learn more about .NET Aspire, read the official documentation.

dotnet workload update --skip-sign-check --interactive
dotnet workload install aspire --skip-sign-check --interactive
dotnet restore eShop.Web.slnf

Warning

Remember to ensure that Docker is started

(Windows only) Run the application from Visual Studio:
- Open the eShop.Web.slnf file in Visual Studio
- Ensure that eShop.AppHost.csproj is your startup project
- Hit Ctrl-F5 to launch Aspire
Or run the application from your terminal:

dotnet run --project src/eShop.AppHost/eShop.AppHost.csproj

then look for lines like this in the console output in order to find the URL to open the Aspire dashboard:

Now listening on: http://localhost:18848

Sample data

The sample catalog data is defined in catalog.json. Those product names, descriptions, and brand names are fictional and were generated using GPT-35-Turbo, and the corresponding product images were generated using DALL·E 3.

Contributing

For more information on contributing to this repo, please read the contribution documentation and the Code of Conduct.

Other eShops

For a closely related version of this app that is not Azure specific, please view the dotnet/eShop repo. These two repos share some common code.