Table of Contents

• Introduction
• Who Is It For?
• Features
• Technologies Used
• Requirements
• Getting Started
• Screenshots
• Contributing
• Demo
• License
• Acknowledgements

Introduction

BlazorShop is an open-source e-commerce platform designed to provide an efficient and user-friendly solution for managing online stores. Built with Blazor, it delivers a seamless experience for both administrators and customers.

Who Is It For?

BlazorShop is ideal for:

• Small to medium-sized businesses looking to manage their online store efficiently.
• Developers wanting to explore Blazor WebAssembly and clean architecture in real-world projects.

Features

• Product Management: Add, edit, and remove products effortlessly.
• Category Management: Organize products into categories for better navigation and management.
• Order Management: Handle customer orders with an intuitive interface.
• Customer Management: Track customer information and their order history.
• Customization: Adaptable to your specific business needs.

Technologies Used

• Backend: ASP.NET Core Web API
• Frontend: Blazor WebAssembly
• Database: Microsoft SQL Server (MSSQL)
• Object-Relational Mapping: EntityFramework Core
• Mapping: AutoMapper
• API Documentation: Swashbuckle (Swagger)

Requirements

Before getting started, ensure you have the following:

• .NET 9 SDK or later
• SQL Server instance (local or cloud)
• A web browser that supports WebAssembly (e.g., Chrome, Edge, Firefox)

Getting Started

Follow these steps to set up and run BlazorShop:

1. Clone the repository:

   git clone https://github.com/unrealbg/BlazorShop.git

2. Navigate to the project directory:

   cd BlazorShop

3. Set up the database:
   • Update the appsettings.json file with your SQL Server connection string.
   • Apply migrations (if applicable):

     dotnet ef database update

4. Build and run the project:

   dotnet run

Screenshots

User Home View

Register Page

Login Page

User Dropdown Menu

My Profile Page

Change Password

User Adds Product to Cart Once

User Adds Same Product Twice

See More Product Details

User Cart

User Select Payment Method

Payment Process

Payment Success

Add Category

Add Category Confirmation

Product Management Page

Add Product to Category

Product Added Successfully

Delete Category Confirmation

Category Deletion Success

Sales Page

Contributing

We welcome contributions to BlazorShop! Here’s how you can get involved:

1. Fork the repository.
2. Create a new branch:

   git checkout -b feature-branch

3. Make your changes and commit them:

   git commit -m 'Add new feature'

4. Push to your branch:

   git push origin feature-branch

5. Open a pull request.

Demo

Check out a live demo of BlazorShop shop.unrealbg.com.

License

BlazorShop is licensed under the MIT License. See the LICENSE file for more details.

Acknowledgements

• unrealbg: The creator and main contributor of BlazorShop.