# Smartstore **Repository Path**: kan-jian/Smartstore ## Basic Information - **Project Name**: Smartstore - **Description**: No description available - **Primary Language**: Unknown - **License**: AGPL-3.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-07-14 - **Last Updated**: 2026-07-14 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README 

Smartstore

Smartstore

Ready. Sell. Grow.

A modular, scalable, and ultra-fast open-source all-in-one eCommerce platform built on ASP.NET Core 10.

Try Online ∙ Developer Guide ∙ Forum ∙ Marketplace ∙ Translations


Smartstore Demo Shop


Smartstore is a cross-platform, modular, scalable, and ultra-fast open-source all-in-one eCommerce platform built on `ASP.NET Core 10`, `Entity Framework Core 10`, `Vue.js`, `Sass`, `Bootstrap`, and more. **Smartstore includes all the essential features to create multi-language, multi-store, and multi-currency shops**, with built-in AI capabilities for text and image generation powered by the world's leading AI providers — targeting desktop and mobile devices alike. It enables SEO-optimized, rich product catalogs with support for an unlimited number of products and categories, variants, bundles, datasheets, ESD, discounts, coupons, and much more. A comprehensive set of tools for CRM & CMS, sales, marketing, payment, and shipping makes Smartstore a powerful all-in-one solution that meets all your needs. **Smartstore delivers a beautiful and fully configurable storefront out of the box**, built with a high-level design approach using `Sass`, `Bootstrap`, and other modern components. The included *Flex* theme is modern, clean, and fully responsive — giving shoppers the best possible experience on any device. The state-of-the-art architecture — with `ASP.NET Core 10`, `Entity Framework Core 10`, and a domain-driven design approach — makes Smartstore easy to extend, extremely flexible, and a pleasure to work with. * :house: **Website:** [https://www.smartstore.com](https://www.smartstore.com) * :orange_book: **Developer Guide:** [Smartstore Developer Guide](https://docs.smartstore.com/developer) * :blue_book: **User Guide:** [Smartstore User Guide](https://docs.smartstore.com) * :speech_balloon: **Forum:** [https://community.smartstore.com](http://community.smartstore.com) * :mega: **Marketplace:** [https://community.smartstore.com/marketplace](http://community.smartstore.com/marketplace) * :earth_americas: **Translations:** [https://translate.smartstore.com](http://translate.smartstore.com/) * ▶️ **Azure Marketplace:** [Smartstore on Azure Marketplace](https://azuremarketplace.microsoft.com/marketplace/apps/smartstore-ag.smartstorenet?tab=Overview)

 

## Technology & Design - State-of-the-art architecture with `ASP.NET Core 10`, `Entity Framework Core 10`, and domain-driven design - Cross-platform: runs on Windows, Linux, and macOS - `Docker` support out of the box for easy deployment - Composable, extensible, and highly flexible through a modular architecture - Highly scalable with full-page caching and web farm support - Powerful theme engine for creating or customizing themes and skins with minimal effort, thanks to theme inheritance - Point & Click theme configuration - Liquid template engine: highly flexible templating for emails and campaigns, with auto-completion and syntax highlighting - HTML-to-PDF converter: generates PDF documents from standard HTML templates, greatly simplifying PDF output customization - Consistent use of modern components such as `Vue.js`, `Sass`, and `Bootstrap` across both frontend and backend - Intuitive shop management through a modern, clean UI

 

## Key Features

Smartstore Screenshots

- Multi-store support - Multi-language with full RTL (right-to-left) and bidirectional text support - Multi-currency support - Product bundles, variants, attributes, ESD, tier pricing, cross-selling, and more - Sophisticated marketing and promotion capabilities (gift cards, reward points, discounts of any kind, and more) - AI-powered features for text and image generation, image editing, and image composition - CMS Page Builder: create compelling, sales-driving content without any coding, using a powerful WYSIWYG editor with a CSS grid system - Reviews and ratings - Media Manager: powerful, lightning-fast media file explorer - Rule Builder: visual business rule creation with dozens of predefined rules out of the box - Search framework with faceted search support — ultra-fast results even with millions of items - Extreme scalability through output caching, `Redis`, and `Microsoft Azure` support - Tree-based permission management (ACL) with inheritance support - Comprehensive import/export framework (profiles, filters, mapping, projections, scheduling, deployment, and more) - Blog, forum, polls, custom pages, and HTML content - CMS Menu Builder: visual manager for all menu types — modify existing menus or create your own and place them anywhere - Modern, clean, SEO-optimized, and fully responsive `Bootstrap`-based theme - Hierarchical SEO slug support, e.g. *samsung/galaxy/s22/32gb/white* - *Trusted Shops* pre-certification and full EU GDPR compliance - 100% compliant with German law - Sales, customer, and inventory management - Comprehensive CRM features - Powerful layered navigation - Numerous payment and shipping providers and options - Wallet: supports full or partial order payment via credit account - TinyImage: achieves ultra-high image compression rates (up to 80%) with WebP support - Preview Mode: easily test themes and stores before going live - RESTful Web API

 

## AI Features Smartstore comes with a built-in AI framework that brings generative AI directly into the merchant workflow — no third-party plugins required. ### Capabilities - **Text generation**: AI-assisted creation and optimization of product descriptions, meta tags, category texts, and other shop content - **Image generation**: Create product and marketing images from text prompts directly within the backend - **Image editing**: Modify and enhance existing images using AI (background removal, retouching, style transfer, and more) - **Image composition**: Combine and merge multiple images into a single, cohesive result ### Supported AI Providers Smartstore integrates with all major AI providers through a unified, provider-agnostic abstraction layer. Switch or combine providers at any time without changing your workflow: | Provider | Text Generation | Image Generation | |---|:---:|:---:| | [OpenAI / ChatGPT](https://openai.com/) | ✔ | ✔ | | [Google Gemini](https://gemini.google.com/) | ✔ | ✔ | | [Anthropic Claude](https://www.anthropic.com/) | ✔ | — | | [DeepSeek](https://www.deepseek.com/) | ✔ | — | | [Ollama](https://ollama.com/) *(self-hosted)* | ✔ | — |

 

## Getting Started ### System Requirements #### Supported Operating Systems - Windows 10 or higher / Windows Server 2016 or higher - Ubuntu 18.04+ - Debian 11+ - macOS 10.11+ #### Supported Database Systems - Microsoft SQL Server 2016 Express or higher - MySQL 8.0+ - PostgreSQL 11+ - SQLite 3.31+ ### Upgrading from Smartstore.NET 4.2 Smartstore 5+ is a port of [Smartstore.NET 4](https://github.com/smartstore/SmartStoreNET) — based on the classic .NET Framework 4.7.2 — to the modern `ASP.NET Core 10` platform. Existing instances based on classic `ASP.NET MVC` can be upgraded seamlessly. To [upgrade](https://smartstore.atlassian.net/wiki/spaces/SMNET50/pages/1956118609/Updating+from+Previous+Versions), simply replace the application files on your server (keep the `App_Data` directory intact) and **all your data will be migrated to the new system automatically**. [See the documentation for detailed installation and upgrade instructions](https://smartstore.atlassian.net/wiki/spaces/SMNET50/pages/1956118822/Installing+Smartstore). > :information_source: Upgrading from versions earlier than 4.2 is not supported. Please migrate to Smartstore.NET 4.2 first, then upgrade to Smartstore 5+. ### Visual Studio 1. Clone the repository: `git clone https://github.com/smartstore/Smartstore.git` and check out the `main` branch. 2. Download [Visual Studio 2026](https://www.visualstudio.com/downloads/) (any edition). 3. Open `Smartstore.sln` and wait for Visual Studio to restore all NuGet packages. 4. Set `Smartstore.Web` as the startup project and run it. ### Repository Structure | Project | Description | |---|---| | [`Smartstore`](https://github.com/smartstore/Smartstore/tree/main/src/Smartstore) | Common low-level, application-agnostic infrastructure: bootstrapper, modularity engine, caching, pub/sub, imaging, type conversion, I/O, templating, scheduling, utilities, and extension methods | | [`Smartstore.Data`](https://github.com/smartstore/Smartstore/tree/main/src/Smartstore.Data) | Database providers | | [`Smartstore.Core`](https://github.com/smartstore/Smartstore/tree/main/src/Smartstore.Core) | Application-specific modules: catalog, checkout, identity, security, localization, logging, messaging, rules engine, search engine, theme engine, migrations, and more | | [`Smartstore.Web.Common`](https://github.com/smartstore/Smartstore/tree/main/src/Smartstore.Web.Common) | Common web features: custom MVC infrastructure, bundling, Tag Helpers, HTML helpers, and more | | [`Smartstore.Modules`](https://github.com/smartstore/Smartstore/tree/main/src/Smartstore.Modules) | All module and plugin projects | | [`Smartstore.Web`](https://github.com/smartstore/Smartstore/tree/main/src/Smartstore.Web) | Entry host project: controllers, model classes, themes, and static assets |

 

## Building Smartstore ### Option 1 — Publish from Visual Studio 1. Open the Smartstore solution in Visual Studio 2026. 2. Switch to the **Release** configuration. 3. Rebuild the solution. 4. Publish the **Smartstore.Web** host project. ### Option 2 — Run a build script Run the build script for your target platform from the **build** directory: `build.{Platform}.cmd`. The output is placed in `build/artifacts/Community.{Version}.{Platform}` and a zip archive is created in `build/artifacts/` automatically. By default, the script produces a self-contained, platform-specific application that bundles the ASP.NET runtime, so it runs on any machine without a pre-installed .NET runtime. Smartstore uses [Nuke](https://nuke.build/) as its build automation solution. You can customize the build process by editing `src/Smartstore.Build/Smartstore.Build/Build.cs`. ### About the `src/Smartstore.Web/Modules` Directory During the build, all modules in `src/Smartstore.Modules/` are detected, compiled, and placed in `src/Smartstore.Web/Modules/`. The runtime loads modules dynamically from this directory. During development this folder is not required — you can safely delete it at any time. ### Creating Docker Images Run `build/dockerize.{Platform}[.nobuild].sh` to create a Docker image. #### `dockerize.linux.sh` Builds a Debian Linux base image with the full ASP.NET runtime, compiles the solution, and publishes a framework-dependent application inside the container. Also installs the native **wkhtmltopdf** library required for PDF generation. #### `dockerize.linux.nobuild.sh` Faster alternative — skips the build step. Requires a pre-built artifact in `build/artifacts/Community.{Version}.linux-x64`. Creates a Debian Linux base image with only the ASP.NET runtime dependencies and copies the artifact. Also installs **wkhtmltopdf**. #### `dockerize.windows.nobuild.sh` Creates a Windows Nano Server base image with only the ASP.NET runtime dependencies and copies the artifact from `build/artifacts/Community.{Version}.win-x64`. Requires the Docker engine to be running a Windows image. ### Creating Docker Containers Run `compose.{DbSystem}.sh` to create a ready-to-use Docker container that includes a database server. #### `compose.mysql.sh` Creates a composite Docker container with the **Smartstore** application image and the latest **MySQL** image. #### `compose.sqlserver.sh` Creates a composite Docker container with the **Smartstore** application image and the latest **MS SQL Server** image.

 

## Try It Online We provide a live demo so you can explore Smartstore without a local installation. Test all features in both the storefront and the backend. Note that the backend demo is shared — other testers may modify data simultaneously. - [**Storefront**](https://core.smartstore.com/frontend/en) (User: `demo`, Password: `1234`) - [**Backend**](https://core.smartstore.com/backend/admin/) (User: `demo`, Password: `1234`)

 

## License Smartstore Community Edition is released under the [AGPL license](https://www.gnu.org/licenses/agpl-3.0.de.html). ⭐ **Star this repository** to stay up to date, follow our progress, and never miss a new release. Contributions and community involvement are always welcome.