Smartstore README

The project's README from github.com/smartstore/Smartstore. As one markdown file: README.md.

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.

 

Technology & Design

 

Key Features

Smartstore Screenshots

 

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

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 ✔ ✔
Google Gemini ✔ ✔
Anthropic Claude ✔ —
DeepSeek ✔ —
Ollama (self-hosted) ✔ —

 

Getting Started

System Requirements

Supported Operating Systems

Supported Database Systems

Upgrading from Smartstore.NET 4.2

Smartstore 5+ is a port of Smartstore.NET 4 — 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, 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.

: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 (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 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 Database providers
Smartstore.Core Application-specific modules: catalog, checkout, identity, security, localization, logging, messaging, rules engine, search engine, theme engine, migrations, and more
Smartstore.Web.Common Common web features: custom MVC infrastructure, bundling, Tag Helpers, HTML helpers, and more
Smartstore.Modules All module and plugin projects
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 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.

 

License

Smartstore Community Edition is released under the AGPL license.

⭐ Star this repository to stay up to date, follow our progress, and never miss a new release. Contributions and community involvement are always welcome.

Smartstore (smartstore/Smartstore)

Searching Database…

Что это?Smartstore — модульная опенсорсная платформа электронной коммерции «всё в одном» на базе ASP.NET Core 10: полноценная витрина магазина плюс бэкенд для управления многоязычным, мультимагазинным и мультивалютным онлайн-магазином.
Это библиотека, которую я добавляю в своё приложение, или полноценное приложение для развёртывания?Это законченное веб-приложение для размещения на собственном сервере со своей витриной и админ-бэкендом, а не библиотека, встраиваемая в другой проект.
Как его запустить?Склонируйте репозиторий, откройте Smartstore.sln в Visual Studio 2026, назначьте Smartstore.Web стартовым проектом и запустите его либо используйте предоставленные скрипты сборки; Docker-образы также можно собрать через скрипты dockerize и compose.
Какая база данных и ОС нужны?Он работает на Windows 10+, Ubuntu 18.04+, Debian 11+ или macOS 10.11+ и поддерживает в качестве базы данных SQL Server 2016+, MySQL 8.0+, PostgreSQL 11+ или SQLite 3.31+.
Можно ли обновить старую установку Smartstore.NET сразу до этой версии?Только если у вас уже Smartstore.NET 4.2; более ранние версии должны сначала мигрировать на 4.2, прежде чем обновляться до Smartstore 5+.
Можно ли попробовать его, прежде чем что-то устанавливать?Да, Smartstore предоставляет живую онлайн-демо, охватывающую и витрину, и админ-бэкенд (логин demo/1234), правда, демо-админка общая с другими тестировщиками.
Каких ИИ-провайдеров он поддерживает из коробки?Smartstore включает встроенный ИИ-фреймворк с поддержкой OpenAI/ChatGPT, Google Gemini, Anthropic Claude, DeepSeek и самостоятельно развёрнутого Ollama для генерации текста, причём OpenAI и Gemini поддерживают ещё и генерацию изображений.
Что умеет встроенный движок тем?В него входит мощный движок тем с наследованием тем, настройкой в пару кликов и шаблонизатором Liquid для гибких шаблонов писем/кампаний, плюс конвертер HTML в PDF.
Масштабируется ли он под большие каталоги?Да, он поддерживает кеширование вывода целых страниц, Redis, работу в веб-фермах и фреймворк фасетного поиска, рассчитанный на сверхбыструю выдачу даже при миллионах товаров.
Creator
smartstore
Size
145.3 MB
Stars
1.7K
Age
6y
Commits · 90 Days