How to run eShopOnWeb with Docker Compose?

From the root folder, run 'docker-compose build' and 'docker-compose up' to start the Web project on port 5106 and Public API on 5200. For login issues, try using an incognito browser session as noted in the README.

eShopOnWeb vs eShopOnContainers: which should I use?

eShopOnWeb focuses on monolithic architecture and is simpler, ideal for learning traditional ASP.NET Core web apps. eShopOnContainers demonstrates microservices and is more complex, suited for understanding distributed systems and container orchestration.

How do I set up the database for eShopOnWeb locally?

Install dotnet-ef tool globally, then from the Web folder, run 'dotnet ef database update' commands for both catalogcontext and appidentitydbcontext. This creates separate databases for catalog and identity data, as detailed in the README setup steps.

Why is the Blazor admin not loading in eShopOnWeb?

The admin requires the PublicApi project to be running alongside the Web project. Ensure both are started—e.g., run 'dotnet run' in the PublicApi folder and 'dotnet run --launch-profile Web' in the Web folder—then access https://localhost:5001/admin.

Can I deploy eShopOnWeb to Azure without Docker?

Yes, use the Azure Developer CLI template by running 'azd init -t dotnet-architecture/eShopOnWeb' and 'azd up'. This provisions Azure resources like SQL Database via Key Vault and deploys the code, handling credentials securely without manual Docker setup.

Is eShopOnWeb good for learning Blazor?

It provides a practical example of Blazor WebAssembly for an admin interface, but it's integrated with a monolithic backend. For broader Blazor learning, consider dedicated samples, as this focuses more on overall architecture than frontend depth.

eShopOnWeb — ASP.NET Core Enterprise Sample

What is eShopOnWeb?

eShopOnWeb is a sample ASP.NET Core 8.0 reference application that demonstrates a monolithic web application architecture. It serves as a learning resource for developers building traditional web apps with enterprise patterns, accompanying the eBook *Architecting Modern Web Applications with ASP.NET Core and Azure*. The application includes features like Entity Framework Core data access, Blazor WebAssembly admin interfaces, and Docker support.

Target Audience

ASP.NET Core developers, especially those new to the framework or seeking to understand enterprise application patterns and monolithic architecture. It is also valuable for teams looking for a reference implementation to guide their own project structures.

Value Proposition

Developers choose eShopOnWeb because it provides a clear, Microsoft-backed example of modern ASP.NET Core practices in a monolithic context, with comprehensive documentation and support for real-world deployment scenarios like Docker and Azure. It contrasts with microservices-focused samples, offering a simpler entry point for learning.

Sample ASP.NET Core 8.0 reference application, now community supported: https://github.com/NimblePros/eShopOnWeb

Use Cases

Best For

Learning ASP.NET Core 8.0 architecture and best practices
Understanding monolithic web application deployment patterns
Referencing Entity Framework Core integration with SQL Server
Exploring Blazor WebAssembly for admin interfaces
Setting up Dockerized development environments for .NET apps
Using Azure Developer CLI for quick Azure deployments

Not Ideal For

Projects requiring a production-ready eCommerce platform with payment processing and inventory management
Teams implementing microservices architectures; eShopOnContainers is the recommended reference for that
Developers seeking a minimal, quick-start template with pre-styled UI components
Environments where avoiding complex multi-project setups and database migrations is a priority

Pros & Cons

Pros

Official Learning Companion

Directly supports the eBook 'Architecting Modern Web Applications with ASP.NET Core and Azure', providing a practical implementation of architectural principles with updated ASP.NET Core 8.0 examples.

Monolithic Architecture Demo

Showcases a single-process deployment model with Entity Framework Core migrations and ASP.NET Core Identity, ideal for understanding traditional web app structures contrasted with microservices.

Modern Tooling Integration

Includes Docker Compose, Dev Container support, and Azure Developer CLI templates, facilitating containerized development and streamlined cloud deployment to Azure.

Blazor WebAssembly Example

Features an admin section built with Blazor WebAssembly that communicates with a separate PublicApi project, offering insights into integrating this technology with ASP.NET Core APIs.

Cons

Development Status Limbo

Active development has shifted to dotnet/eShop, and this repository is community-supported, potentially leading to outdated code or slower updates compared to official Microsoft samples.

Setup Complexity

Requires running separate EF Core migrations for catalog and identity databases, and coordinating multiple projects (Web and PublicApi) for full functionality, which can be error-prone for newcomers.

Incomplete eCommerce Features

As admitted in the README, it lacks essential eCommerce functionalities like persistent shopping carts or payment integration, limiting its use as a real-world reference beyond architecture lessons.

Blazor-Centric Admin

The admin interface relies on Blazor WebAssembly, which may not align with teams using other frontend frameworks like React or Angular, adding learning curve for those ecosystems.

What is eShopOnWeb?

Target Audience

Value Proposition

Use Cases

Best For

Learning ASP.NET Core 8.0 architecture and best practices
Understanding monolithic web application deployment patterns
Referencing Entity Framework Core integration with SQL Server
Exploring Blazor WebAssembly for admin interfaces
Setting up Dockerized development environments for .NET apps
Using Azure Developer CLI for quick Azure deployments

Not Ideal For

Projects requiring a production-ready eCommerce platform with payment processing and inventory management
Teams implementing microservices architectures; eShopOnContainers is the recommended reference for that
Developers seeking a minimal, quick-start template with pre-styled UI components
Environments where avoiding complex multi-project setups and database migrations is a priority

Pros & Cons

Pros

Official Learning Companion

Monolithic Architecture Demo

Showcases a single-process deployment model with Entity Framework Core migrations and ASP.NET Core Identity, ideal for understanding traditional web app structures contrasted with microservices.

Modern Tooling Integration

Includes Docker Compose, Dev Container support, and Azure Developer CLI templates, facilitating containerized development and streamlined cloud deployment to Azure.

Blazor WebAssembly Example

Features an admin section built with Blazor WebAssembly that communicates with a separate PublicApi project, offering insights into integrating this technology with ASP.NET Core APIs.

Cons

Development Status Limbo

Active development has shifted to dotnet/eShop, and this repository is community-supported, potentially leading to outdated code or slower updates compared to official Microsoft samples.

Setup Complexity

Requires running separate EF Core migrations for catalog and identity databases, and coordinating multiple projects (Web and PublicApi) for full functionality, which can be error-prone for newcomers.

Incomplete eCommerce Features

As admitted in the README, it lacks essential eCommerce functionalities like persistent shopping carts or payment integration, limiting its use as a real-world reference beyond architecture lessons.

Blazor-Centric Admin

The admin interface relies on Blazor WebAssembly, which may not align with teams using other frontend frameworks like React or Angular, adding learning curve for those ecosystems.

eShopOnWeb

What is eShopOnWeb?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions

Related Projects

Found a gem we're missing?

eShopOnWeb

What is eShopOnWeb?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions

Related Projects

Found a gem we're missing?