eShop is a reference .NET application demonstrating an e-commerce website built with a services-based architecture. It targets .NET developers looking to understand and implement modern .NET patterns, particularly with .NET Aspire, offering a practical example for building and deploying cloud-native applications.

How It Works

This application leverages .NET Aspire for orchestration, service discovery, and observability. It employs a microservices approach, with distinct services handling different aspects of the e-commerce domain. The architecture is designed to showcase best practices for building resilient, scalable, and observable distributed systems within the .NET ecosystem.

Quick Start & Requirements

• Install: Clone the repository and follow setup instructions for Visual Studio 2022 (Windows) or VS Code (Mac/Linux/Windows).
• Prerequisites: .NET 9 SDK, Docker Desktop (Windows), Visual Studio 2022 (with ASP.NET and web development workload, .NET Aspire SDK component), or VS Code with C# Dev Kit. Rosetta 2 required for Mac Apple Silicon.
• Setup: Environment configuration scripts are provided.
• Running: Launch from Visual Studio (using eShop.Web.slnf) or via dotnet run --project src/eShop.AppHost/eShop.AppHost.csproj.
• Docs: https://aka.ms/aspnet/https-trust-dev-cert

Highlighted Details

• Implements a services-based architecture using .NET Aspire.
• Demonstrates integration with Azure OpenAI for AI-powered features.
• Supports deployment to Azure using Azure Developer CLI (azd).
• Sample data (product names, descriptions) generated using GPT-35-Turbo and DALL·E 3.

Maintenance & Community

The project is maintained by the .NET team. Contribution guidelines and a Code of Conduct are available.

Licensing & Compatibility

The repository does not explicitly state a license in the provided README. Compatibility for commercial use or closed-source linking is not specified.

Limitations & Caveats

The README mentions a specific version based on .NET 9 and provides links to previous versions for .NET 8, indicating potential for breaking changes between major releases. Azure OpenAI integration requires manual configuration.