GrandNode - open-source e-commerce platform for .NET

Free, fast and feature-rich online store software built with ASP.NET Core 10 and MongoDB.
Multi-store, multi-vendor marketplace, B2B and B2C, multi-language and multi-currency - in one self-hosted application.

Live demo · Website · Documentation · Discussions · Themes · Integrations & plugins · Premium support

Table of Contents

• What is GrandNode?
• Key features
• Technology stack
• Quick start
• Online demo
• Documentation
• Community and support
• Contributing
• Sponsors
• License

What is GrandNode?

GrandNode is a free, open-source e-commerce platform written in C# on ASP.NET Core, with MongoDB as its database. It runs a single online shop just as well as a multi-store installation or a multi-vendor marketplace, serves B2B and B2C customers from the same catalog, and exposes a REST API for headless storefronts, mobile apps and integrations with ERP, PIM and CRM systems.

It is built for developers and agencies on .NET who need a shopping cart they can host anywhere - on Linux, Windows, in Docker or Kubernetes - and extend with plugins and themes, without per-store licence fees.

Key features

Selling

• 🏪 Multi-store - run many storefronts, domains and catalogs from one installation, with a separate store owner panel
• 🤝 Multi-vendor marketplace - vendors manage their own products and orders in a dedicated vendor panel
• 👥 B2B and B2C - customer groups, tier prices, sales employees
• 🌎 Multi-language and multi-currency - localized content, right-to-left support, automatic exchange rates
• 🛒 Advanced product catalog - product attributes and combinations, bundles, grouped products, downloadable products, reservations and auctions
• 💳 Payments - Stripe Checkout, Braintree, cash on delivery and more through plugins
• 🚚 Shipping - fixed rate, by weight, pickup points
• 🧾 Taxes - fixed rate or by country, state and zip code

Marketing and SEO

• 🔍 SEO-friendly - clean URLs, meta tags, canonical URLs, XML sitemaps and schema.org JSON-LD with price, availability, rating, shipping and return policy
• 🏷️ Discounts and promotions - coupon codes, discount rules, loyalty points, gift vouchers
• 🎯 Customer segmentation - target customer groups and tags with content, prices and discounts
• 📧 Newsletters and messaging - message templates, campaigns, push notifications
• 📊 Analytics - Google Analytics and Facebook Pixel integrations

Look and feel

• 🎨 Themes - Default, Modern and Nordic Editorial storefront themes included, with per-store theme selection
• 📱 Responsive - Vue 3 and Bootstrap 5 storefront that works on every device
• 🧩 Content - CMS pages, blog, news, sliders and widget zones

Technology stack

Quick start

Prerequisites

The develop branch is the development version and may be unstable; main holds the latest stable version. Stable versions are also on the Releases page.

Run with Docker

docker run -d -p 127.0.0.1:27017:27017 --name mongodb mongo
docker run -d -p 80:8080 --name grandnode2 --link mongodb:mongo -v grandnode_images:/app/wwwroot/assets/images -v grandnode_appdata:/app/App_Data grandnode/grandnode2

Open http://localhost, and the installer asks for the MongoDB connection string (mongodb://mongo/grandnode with the commands above) and the administrator account.

Run from source

git clone https://github.com/grandnode/grandnode2.git
cd grandnode2
dotnet build GrandNode.slnx
dotnet run --project src/Web/Grand.Web

Build the whole solution once before the first run: plugins and modules copy themselves into the web project's output when they are built. Run with ASPNETCORE_ENVIRONMENT=Development (the launch profiles already set it), otherwise the admin panel loads without its CSS and JavaScript.

More ways to install - several instances behind a load balancer, hosting on Linux with systemd - are in docs/installation.md. Building the frontend bundles and working on the code are in docs/development.md.

Online demo

• Storefront: demo.grandnode.com
• Admin panel: demo.grandnode.com/admin - email admin@yourstore.com, password 123456

The demo is restored to its original state once per day.

Documentation

• Installation - Docker, multiple instances, Linux hosting
• Development - building the backend and frontend, running locally
• User and developer guides on docs.grandnode.com
• Contributing guide

Community and support

• Questions and ideas: GitHub Discussions
• Bugs and feature requests: GitHub Issues
• Security vulnerabilities: see the security policy - please do not open public issues
• Commercial help: premium support packages

See SUPPORT.md for where each kind of question goes.

Contributing

GrandNode is and always will be free and open-source. You can help by:

• starring the project on GitHub, so other .NET developers find it,
• reporting bugs and suggesting features in Issues,
• picking up a good first issue and submitting a pull request - see CONTRIBUTING.md,
• becoming a sponsor.

GrandNode has adopted the Contributor Covenant as its Code of Conduct.

Sponsors

Become a sponsor and get your logo on this README with a link to your site: become a sponsor on Open Collective.

License

GrandNode is free software distributed under the GNU General Public License v3.0.