NOTE: This fork of Smartstore hosts the plugin source code for the BTCPay Server integration. You can view its README at src/Smartstore.Modules/Smartstore.BTCPayServer/README.md.
Running build-btcpayplugin.ps1
or build-btcpayplugin.sh
will build the plugin and place the resulting zip file in build/packages
which you can then use to install.
A github actions workflow is configured to automatically build and release the plugin when a new tag is pushed to the repository.
The workflow will build the plugin and upload it to the releases page
The tag name must be in the format BTCPayServer/{version}
, where {version}
is the version of the plugin as defined in src\Smartstore.Modules\Smartstore.BTCPayServer\module.json
.
Simply run docker compose up
in this directory and the latest version of SmartStore will be run on http://localhost
. Just use the SQLite db option and you're good to go.
A modular, scalable and ultra-fast open-source all-in-one eCommerce platform built on ASP.NET Core 7.
Try Online โ Forum โ Marketplace โ Translations
Smartstore is a cross-platform, modular, scalable and ultra-fast open source all-in-one eCommerce platform based on ASP.NET Core 7, Entity Framework, Vue.js, Sass, Bootstrap and more.
Smartstore includes all the essential features to create multi-language, multi-store, multi-currency shops targeting desktop or mobile devices and enables SEO-optimised, rich product catalogs with support for 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 & Shipping Handling etc. makes Smartstore a powerful all-in-one solution that meets all your needs.
Smartstore delivers a beautiful and configurable shop frontend out-of-the-box, built with a high level design approach, including components like Sass
, Bootstrap
and others. The included Flex theme is modern, clean and fully responsive, giving shoppers the best possible shopping experience on any device.
The state-of-the-art architecture of Smartstore - with ASP.NET Core 7
, Entity Framework Core 7
and Domain Driven Design approach - makes it easy to extend, extremely flexible and basically fun to work with ;-)
- ๐ Website: http://www.smartstore.com
- ๐ฌ Forum: http://community.smartstore.com
- ๐ฃ Marketplace: http://community.smartstore.com/marketplace
- ๐ Translations: http://translate.smartstore.com/
- ๐ Documentation: Smartstore Documentation in English
โถ๏ธ Azure Marketplace: https://azuremarketplace.microsoft.com
ย
- State-of-the-art architecture with
ASP.NET Core 7
,Entity Framework Core 7
and domain-driven design - Cross-platform: run it on Windows, Linux, or Mac
- Supports
Docker
out of the box for easy deployment - Composable, extensible and highly flexible due to modular design
- Highly scalable with full page caching and web farm support
- Powerful theme engine allows you to create or customise themes & 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: creates PDF documents from regular HTML templates, radically simplifying the customisation of PDF output
- Consistent and sophisticated use of modern components such as
Vue.js
,Sass
,Bootstrap
& more in the front and back end. - Easy shop management thanks to modern and clean UI
ย
- Multi-store support
- Multi-language and full RTL (Right-to-Left) and Bidi(rectional) support
- Multi-currency support
- Product bundles, variants, attributes, ESD, tier pricing, cross-selling and more
- Sophisticated marketing & promotion capabilities (gift cards, reward points, discounts of any kind, and more)
- Reviews & Ratings
- Media Manager: powerful and lightning fast media file explorer
- Rule Builder: powerful rule system for visual business rule creation with dozens of predefined rules out-of-the-box
- Search framework with faceted search support. Ultra-fast search results, even with millions of items!
- Extremely scalable through output caching, REDIS & Microsoft Azure support
- Tree-based permission management (ACL) with inheritance support
- Sophisticated import/export framework (profiles, filters, mapping, projections, scheduling, deployment... basically everything!)
- CMS Page Builder: Create compelling content that drives sales. No coding required thanks to a powerful WYSIWYG editor using the revolutionary CSS grid system
- Blog, forum, polls, custom pages & HTML content etc.
- CMS Menu Builder: visual manager for all kinds of menus. Modify existing menus or create your own and place them anywhere you want.
- Modern, clean, SEO-optimized and fully responsive
Bootstrap
-based theme - Support for hierarchical SEO slugs, e.g.: samsung/galaxy/s22/32gb/white
- Trusted Shops pre-certification and full EU-GDPR compliance
- 100% compliant with German law
- Sales-, Customer- & Inventory Management
- Comprehensive CRM features
- Powerful layered shop navigation
- Numerous payment and shipping providers and options
- Wallet: allows full or partial payment of orders via credit account
- TinyImage: achieves ultra-high image compression rates (up to 80%!) and enables WebP support
- Preview Mode: virtually test themes and stores more easily
- RESTful WebApi (coming soon)
ย
- Windows 10 (or higher) / Windows Server 2012 R2 (or higher)
- Ubuntu 14.04+
- Debian 11+
- Mac OS X 10.11+
- Microsoft SQL Server 2008 Express (or higher)
- MySQL 8.0+
- PostgreSQL 11+
- SQLite 3.31+
Smartstore 5 is a port of Smartstore.NET 4 - based on the classic .NET Framework 4.7.2 โ to the new ASP.NET Core 7
platform. Smartstore instances based on classic ASP.NET MVC
can be upgraded seamlessly. To upgrade, all you need to do is replace the application files on your server - except for the App_Data
directory - and all your data will automatically be transferred to the new system. See the documentation for detailed information on installing or upgrading your store.
โน๏ธ Upgrading from versions older than 4.2 is not possible. Therefore, you should migrate Smartstore.NET to version 4.2 first and then upgrade to Smartstore 5.
- Clone the repository using the command
git clone https://github.com/smartstore/Smartstore.git
and checkout themain
branch. - Download Visual Studio 2022 (any edition) from https://www.visualstudio.com/downloads/
- Open
Smartstore.sln
and wait for Visual Studio to restore all NuGet packages - Make sure
Smartstore.Web
is the startup project and run it
Smartstore
contains common low-level application-agnostic stuff like bootstrapper, modularity engine, caching, pub/sub, imaging, type conversion, IO, templating, scheduling, various utilities, common extension methods etc.Smartstore.Data
contains database providersSmartstore.Core
contains application specific modules like catalog, checkout, identity, security, localization, logging, messaging, rules engine, search engine, theme engine, migrations etc.Smartstore.Web.Common
contains common web features like custom MVC infrastructure, bundling, TagHelpers, HtmlHelpers etc.Smartstore.Modules
contains all module/plugin projectsSmartstore.Web
is the entry host project that contains controllers, model classes, themes, static assets etc.
ย
- Open the Smartstore solution in Visual Studio 2022
- Use Release configuration
- (Re)build the solution
- Publish host project Smartstore.Web
Run the build script corresponding to your target platform in the build directory: build.{Platform}.cmd
. The resulting build will be placed in the build/artifacts/Community.{Version}.{Platform}
directory. A zip archive in build/artifacts/ is created automatically.
By default, the build script produces a platform-specific, self-contained application that includes the ASP.NET runtime and libraries, the Smartstore application and its dependencies. You can run it on any machine that doesn't have the .NET runtime installed.
Smartstore uses Nuke (https://nuke.build/) as its build automation solution, which makes it easy to customize the build process by editing src/Smartstore.Build/Smartstore.Build/Build.cs
.
While building the solution, all modules in src/Smartstore.Modules/
are detected, compiled and placed in the src/Smartstore.Web/Modules/
directory. The application runtime uses this directory as a source from which modules are
loaded dynamically. During development, however, the "Modules" directory is irrelevant. You can safely delete it at any time.
To create a Docker image, run build/dockerize.{Platform}[.nobuild].sh
.
Creates a Debian Linux base image including the complete ASP.NET runtime, builds the solution and publishes a framework-dependent application inside the Linux container. It also installs the native wkhtmltopdf library needed to generate PDF files.
Much faster, but requires that the application has already been built and is located in build/artifacts/Community.{Version}.linux-x64
. Creates a Debian Linux base image with only the ASP.NET runtime dependencies and copies the build artifact. It also installs the native wkhtmltopdf library needed to generate PDF files.
Creates a Windows Nano Server base image with only the ASP.NET runtime dependencies and copies the build artifact. Requires that the application has already been built and is located in build/artifacts/Community.{Version}.win-x64
. It also requires that the Docker engine is running a Windows image.
To create a ready-to-run Docker container with a database server run compose.{DbSystem}.sh
.
Creates a composite Docker container containing the smartstore application image and the latest MySql image.
Creates a composite Docker container containing the smartstore application image and the latest MS SQL Server image.
ย
We have set up a live online demo for you to test Smartstore without a local installation. Get a first impression and test all available features in the frontend and backend. Please note that the backend demo is shared and other testers can modify data at the same time.
ย
Smartstore Community Edition is released under the AGPL license.
Add a star to our new repository to stay up-to-date, get involved or just watch how we're doing. Learn about the latest developments, actively participate and don't miss out on new releases.