Info

eShop Reference Application - AdventureWorks

7/18/2025

eShop Reference Application - AdventureWorks

A reference .NET application implementing an e-commerce website using a services-based architecture using .NET Aspire.

eShop Reference Application

eShop

Getting Started

This version of eShop is based on .NET 9.

Previous eShop versions: .NET 8

Prerequisites

Windows with Visual Studio

  • Install Visual Studio 2022 version 17.10 or newer.
    • Select the following workloads:
      • ASP.NET and web development workload.
      • .NET Aspire SDK component in Individual components.
      • Optional: .NET Multi-platform App UI development to run client apps

Or

  • Run the following commands in a Powershell & Terminal running as Administrator to automatically configure your environment with the required tools to build and run this application. (Note: A restart is required and included in the script below.)

'''shell install-Module -Name Microsoft.WinGet.Configuration -AllowPrerelease -AcceptLicense -Force

$env:Path = [System.Environment]::GetEnvironmentVariable(“Path”,“Machine”) + ”;” + [System.Environment]::GetEnvironmentVariable(“Path”,“User”)

get-WinGetConfiguration -file ..configurations\vside.dsc.yaml | Invoke-WinGetConfiguration -AcceptConfigurationAgreements '''

Or

  • From Dev Home go to Machine Configuration -> Clone repositories. Enter the URL for this repository. In the confirmation screen look for the section Configuration File Detected and click Run File.

Mac, Linux, & Windows without Visual Studio

Or

  • Run the following commands in a Powershell & Terminal running as Administrator to automatically configuration your environment with the required tools to build and run this application. (Note: A restart is required after running the script below.) Install Visual Studio Code and related extensions

'''shell install-Module -Name Microsoft.WinGet.Configuration -AllowPrerelease -AcceptLicense -Force

$env:Path = [System.Environment]::GetEnvironmentVariable(“Path”,“Machine”) + ”;” + [System.Environment]::GetEnvironmentVariable(“Path”,“User”)

get-WinGetConfiguration -file ..configurations\vscode.dsc.yaml | Invoke-WinGetConfiguration -AcceptConfigurationAgreements '''

← Back to projects