Skip to content
vendurehqPublic

About

Open-source headless commerce platform built with TypeScript, NestJS, React, and GraphQL

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

8.5k stars

Watchers

88 watching

Forks

Latest commit

 

History

9,007 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

The ecommerce platform for complex B2B

Website · Documentation · Pricing · Blog · Discord

Vendure: the ecommerce platform for complex B2B, built on GraphQL, NestJS and React

@vendure/core on npm Vendure is released under the GPLv3 licence GitHub stars Commits per month Join our Discord PRs welcome


Why Vendure

Vendure is a commerce backend that engineering teams can change at the core. Model the catalog, orders, pricing, promotions and customers the way your business works, and serve B2B, D2C, marketplace and omnichannel sales from one GraphQL API.

  • Model your business, no forks required: Extend or override any part of the system through stable plugin contracts and service overrides. Add custom entities, pricing logic, and workflows, and change core behaviour without patching it.
  • One backend, every channel: A single extensible core serves any frontend through a GraphQL API, across D2C, B2B, marketplace, and omnichannel. No stitching together separate commerce services.
  • One TypeScript stack: Node.js, NestJS, and GraphQL, with strong types across the stack and no proprietary query language. The introspectable GraphQL schema makes it straightforward to wire up LLM tool-calling, MCP servers, and agent frameworks.
  • Commerce building blocks from day one: Catalog, orders, customers, promotions, channels, tax, shipping, payments, and stock are built in. The same extension model lets you build the workflows specific to your business on top.
  • Proven in production: Used in production by enterprise teams and proven at high transaction volume. Stable plugin contracts give you safe extension points without forking.

Learn why we built Vendure this way · See how Vendure compares · Moving from another platform


Installation

Quick start

Scaffold a project with the server, worker, admin dashboard and GraphQL APIs ready to run:

npx @vendure/create my-shop

Requires Node.js 20.19+ or 22.12+ and a SQL database (PostgreSQL, MySQL, MariaDB or SQLite). The getting started guide covers configuration, seed data and your first plugin. Ask questions on our Discord.

Self-hosting

Vendure runs anywhere Node.js runs, including Docker, Kubernetes, a single VM or any cloud provider. Self-hosting is free, and your data stays in your own database. See the deployment guides.

Vendure Cloud

Vendure Cloud is the managed runtime for Vendure. It deploys on git push, creates a preview environment for every pull request, and manages the database, queues, search, backups and scaling. It runs the same application you can self-host, so you can move to Cloud without rebuilding it. Every paid plan includes Cloud at no extra cost. Cloud is in design-partner preview now, with general availability planned for Q1 2027.


What Core includes

Plugins let you extend or replace any of the features below.

Feature What it covers
Catalog Products, variants, facets, collections and custom fields on any entity
Orders Carts, draft orders, modifications, fulfillment and returns
Stock Multi-location inventory, allocation and backorders
Promotions Conditions and actions you compose, or write your own
Payments Provider-agnostic payment and shipping integrations
Channels Multi-channel, multi-region, multi-currency and multi-language from one instance
Plugins Extend or override any service, entity or strategy without forking the core
GraphQL APIs Typed Shop and Admin APIs that you can extend. Agent frameworks and MCP servers can read the schema through introspection
Dashboard React and TanStack admin app, extensible with your own pages and form elements
TypeScript API Typed reference docs for every service, strategy and event

Beyond the open-source core

Vendure has four paid plans built on top of this repository: Starter, Growth, Scale and Enterprise. They add B2B features such as company accounts, quotes, contract pricing, account hierarchies, approvals, single sign-on and audit logs. Every paid plan also includes direct support from the Vendure team, a commercial license and Vendure Cloud at no extra cost. See plans and pricing.

What's in this repo

This is the Vendure source monorepo: the @vendure/core framework, the React and TanStack admin dashboard, the CLI, the official plugins, and an e2e testing harness. To build with Vendure, run npx @vendure/create (see Getting started) rather than cloning; clone this repo only to contribute to Vendure itself.

Contribution

Contributions are welcome: bugs, features, or docs. Our Contribution Guide covers everything from setting up your development environment to submitting your first pull request.

Pick up a labelled issue as a good first contribution.

Security

To report a suspected security vulnerability, use GitHub's private vulnerability reporting. Do not disclose security vulnerabilities through public GitHub issues or email. See our security policy for details.

Releases

Patch releases ship regularly. Check our release notes to keep up to date.

License

Vendure is open source under the GPLv3 license. Building against the GraphQL API doesn't make your storefront or services subject to GPLv3, and a plugin license exception lets you release your own Vendure plugins under any license you choose (see the licensing FAQ). Every paid plan includes a commercial license. See pricing.

Professional services

Need help getting your build to production? Our team offers professional services: architecture review, implementation support, and launch readiness from the people who build Vendure.

About

Open-source headless commerce platform built with TypeScript, NestJS, React, and GraphQL

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

8.5k stars

Watchers

88 watching

Forks

Releases

Used by

Contributors

Languages