In this workshop, you'll learn by building out features of the eShop Reference Application. We'll start from File/New and build up to some API back-end applications, a web front-end application, and a .NET Aspire AppHost project to coordinate them all together.

If you're on Windows and using Visual Studio, you must use Visual Studio 2022 Preview (version 17.9.0 Preview 5.0 or later). The preview version of Visual Studio 2022 is safe to install side-by-side with the release version. We recommend using Visual Studio 2022 Preview if you're on Windows as it includes support for working with .NET Aspire projects.

Note: When installing Visual Studio you only need to install the ASP.NET and web development workload.

If you're in an instructor-led workshop session and have issues downloading the installers we may have USB sticks with offline installers for you to use.

If you're using macOs or Linux, or on Windows but don't want to use Visual Studio, you must download and install the .NET SDK (version 8.0.101 or newer). You can use the editor or IDE of your choice but note that some operations might be more difficult due to lack of support for .NET Aspire at this time.

After installing Visual Studio Preview or the required .NET SDK, you will need to update and install the .NET SDK workload for Aspire. This workshop is using an as yet unreleased preview of .NET Aspire (preview.3) which requires special steps to install. For your convenience, scripts are provided in this repository to make this process easy:

1. Clone this repo to your machine.

2. In your terminal, navigate to the repo root and run the command dotnet --version to verify you are using version 8.0.101 or later of the .NET SDK:

   dotnet --version

3. Run the build.cmd or build.sh script in the root of this repo, as appropriate for your operating system and terminal:

   build.cmd

   build.sh

4. This script will download and install the latest build of the preview.3 version of the Aspire workload, followed by building all solutions in this repo.

5. If your machine is successfully configured, you should see a message indicating the build succeeded:

   Build succeeded.
   0 Warning(s)
   0 Error(s)

6. For troubleshooting steps regarding installing and updating the Aspire workload, see the documentation here.

The workshop consists of a series of labs, over which you'll build the eShop application.

1. Create the Catalog API
2. Create the Blazor frontend
3. Add an Identity Provider & authentication
4. Add shopping basket capabilities
5. Add checkout & order capabilities
6. Add resiliency
7. Deployment