eCommerceMVCCore

A .NET 10 port of eCommerceMVC — an ASP.NET Core MVC e-commerce platform with a public storefront, an admin dashboard, and a JWT-secured JSON API for mobile clients.

Try it live

ecommercemvc.azurewebsites.net — a free-tier Azure deployment seeded with the same demo catalog described in Demo Data. It runs on Azure App Service's Free tier, so the first request after a period of inactivity may take a few extra seconds to wake up.

What this documentation covers

Everything you need to configure, set up, and run your own instance: build/run instructions, the full site-configuration reference, the API surface, and step-by-step walkthroughs (with real screenshots) of every storefront and admin-dashboard flow.

Tech stack

ASP.NET Core 10 MVC (Razor views, three areas: storefront, Dashboard, API)
Entity Framework Core 10 — code-first migrations, lazy-loading proxies, pluggable database provider (SQL Server, MySQL, PostgreSQL, or SQLite — see Database Providers)
ASP.NET Core Identity — cookie authentication for the storefront/dashboard, JWT bearer for the API
LigerShark.WebOptimizer for CSS/JS bundling

Where to start

Setup & Reference

Build/run the project, configure the database, understand the code layout, the full configuration key reference, the API, FAQs, and demo data.

Start with Setup →

Storefront (User) Guide

Walk through browsing, search, registration, cart, checkout, order tracking, reviews, and newsletter — with real screenshots of each step.

Start with Browsing & Search →

Admin Dashboard Guide

Manage categories, products, orders, promo codes, users, roles, comments, languages, and site configuration from /dashboard.

Start with Dashboard Overview →

API Reference

JWT authentication, the response envelope, and every endpoint under /api/{lang}/... for building a mobile or headless client.

Read the API Reference →

Docker

Run the app and its database as containers — one Compose profile per database provider, no local .NET SDK or database install required.

Set up Docker →

Quick facts

Local dev URL: http://localhost:5209 (see Setup)
Seeded admin login: Username adm_use, password adm_use123 — change this before deploying anywhere real
Payment methods: Cash on Delivery, PayPal (PayPal account and debit/credit card) — see PayPal Payments
Database: SQL Server (LocalDB by default) via EF Core, auto-migrated and seeded on first run

Every screenshot and fact in this documentation was captured directly from a running instance of this codebase

Not copied from any other version’s documentation — ports, default values, and behavior can drift between snapshots of this project, so treat this folder as the source of truth for this copy of the code.