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