🎉 Spurtcommerce v5.3 is now available!

Opensource Multi Vendor Marketplace for B2C , B2B

Build with Nodejs + TypeScript + Angular + React + MySQL and PostgreSQL

Website • Discord • Community • Twitter • Reddit • Documentation

Join Our Community

[!IMPORTANT] 🎉 Spurtcommerce 5.3.0 is now available! Read more in the announcement post.

❯ 🚀 Updated: Run & deploy (mono-repo)

This repository contains multiple apps. The sections below explain how to run each app from the workspace — no compilation is required because compiled assets are included for admin/seller and the API.

Prerequisites

• Node.js (v22.14.0)
• npm (recommended >= 9.6.0)
• MySQL server (for the API database)

API (backend)

1. Change to the API folder and install dependencies:

cd api
npm install

2. Configure the environment: create and edit api/.env with your DB credentials and app settings. Import the sample SQL if needed:

mysql -u <user> -p <database> < spurtcommerce-demo.sql

3. Start the API (compiled files are included):

npm start

The start script runs the compiled server (typically node dist/src/app.js). The API listens on the port set in your .env.

Admin frontend

1. Install dependencies and ensure admin/.env is present:

cd admin
npm install

2. Start the admin server (the prestart script runs scripts/generate-env.js):

npm start

The app is served from dist/admin. Set PORT in .env to change the port (default 4200).

Seller (vendor) frontend

1. Install dependencies:

cd seller
npm install

2. Start the seller server (prestart runs scripts/generate-env.js):

npm start

The app is served from dist/vendor.

Store (Next.js storefront)

1. Install dependencies:

cd store
npm install

2. (Optional) Populate runtime config from runtime-config.json.template:

npm run generate-env

3. Run in development:

npm start

The storefront reads runtime configuration from store/public/runtime-config.json — run npm run generate-env before building for production if you use template placeholders.

Completion of the above steps sets up and runs the backend and frontends on your machine.

Default Admin Panel Login Details

Username : "[email protected]"
Password : "Piccosoft2012"

Above steps concludes successful installation and setup of Spurtcommerce Marketplace solution build in your local (or) server.

🤔 Support , Document and Help

Spurtcommerce 5.3.0 is published to npm under the @spurtcommerce/* namespace.

You can find our extended documentation on our www.spurtcommerce.dev, but some quick links that might be helpful:

• Read Technology to learn about our vision and what's in the box.

• Our Discard Questions, Live Discussions Spurtcommerce Support.

• An API Reference contains the details on Spurtcommerce foundational building blocks.

• Some Video Video Tutorials

• Every Release is documented on the Github Releases page.

🐞 If you spot a bug, please submit a detailed issue, and wait for assistance.

🤔 If you have a question or feature request, please start a new discussion.

🤔 This project is tested with BrowserStack

❯ Maintainers

Spurtcommerce is developed and maintain by Piccosoft Software Labs India (P) Limited,.

❯ License

Spurtcommerce is released under the BSD-3-Clause License..