eShop Sample 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/eshop
• (Windows only) Install Visual Studio Int Preview: https://aka.ms/vs/17/intpreview/vs_enterprise.exe
• Install & start Docker Desktop: https://docs.docker.com/engine/install/
• Install the Azure Artifacts Credential Provider from https://github.com/microsoft/artifacts-credprovider
• Install the .NET 8 SDK version 8.0.100-rtm.23530.12 or newer.
  • Windows x64 link
  • Linux x64 link
  • macOS Arm64 link
  • macOS x64 link and ensure this dotnet is on your PATH.

Running the solution

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.

TODO

• Contribution guide
• Architecture Overview
• Link to books
• Link to Aspire docs