Skip to content

This workshop will teach you ASP.NET Core & .NET Aspire by building the product catalog & order placement features of the eShop reference application.

License

Notifications You must be signed in to change notification settings

dotnet-presentations/eshop-app-workshop

Repository files navigation

.NET eShop - App Building Workshop

CI

What you'll be building

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.

eShop Home

Setup

Using Windows and Visual Studio

If you're on Windows and using Visual Studio, you must use Visual Studio 2022 Preview (version 17.10.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.

Using macOS, Linux, or Windows but not using Visual Studio

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.100 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.

Updating and installing the .NET SDK workload for Aspire

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 the latest version of .NET Aspire (8.2). 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.100 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 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)

Labs

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

About

This workshop will teach you ASP.NET Core & .NET Aspire by building the product catalog & order placement features of the eShop reference application.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published