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 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
- 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
- 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:
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 — 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
- Clone the repository:
git clone https://github.com/smartstore/Smartstore.git and check out the main branch.
- Download Visual Studio 2026 (any edition).
- Open
Smartstore.sln and wait for Visual Studio to restore all NuGet packages.
- 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
- Open the Smartstore solution in Visual Studio 2026.
- Switch to the Release configuration.
- Rebuild the solution.
- 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 是基于 ASP.NET Core 10 构建的模块化开源一体化电商平台，提供完整的店铺前端和管理后台，用于管理多语言、多店铺、多币种的在线商店。