Skip to content

JavaScript Open Source
Multi-Vendor Marketplace Accelerator build on top of Medusa.js. Mercur simplifies the path to your own customized, multi-vendor marketplace.

License

Notifications You must be signed in to change notification settings

mercurjs/mercur

Repository files navigation

Mercur

Marketplace solution built on top of Medusa 2.0

Table

Prerequisites

  • Node.js v20+
  • PostgreSQL
  • Git CLI

 

Features

  • Product management. Sellers can manage their products and variants.
  • Order management. Sellers can manage their orders.
  • Stock location and inventory managment. Sellers can create stock locations and manage their inventory.
  • Team management. Sellers can invite and manage their team members.
  • Fulfillment management. Sellers can manage their fulfillments, shipping options and delivery types.
  • Order spliting. Orders are splitted into multiple orders by sellers in the cart.
  • OpenAPI support. Mercur API endpoints are available via OpenAPI.
  • Payouts. Automated payouts to sellers.
  • Stripe Connect Integration. Integration with Stripe Connect for payment and payout processing.

 

Quickstart

Setup Medusa project

# Clone the repository
git clone https://github.com/mercurjs/mercur.git

# Install dependencies
yarn install

# Go to backend folder
cd apps/backend

# Clone .env.template
cp .env.template .env

# In the .env file replace user, password, address and port parameters in the DATABASE_URL variable with your values
DATABASE_URL=postgres://[user]:[password]@[address]:[port]/$DB_NAME
# For example:
DATABASE_URL=postgres://postgres:postgres@localhost:5432/$DB_NAME

# Setup database and run migrations
yarn medusa db:create && yarn medusa db:migrate && yarn run seed

# Generate OpenAPI client
yarn generate:oas

# Create admin user
npx medusa user --email <email> --password <password>

# Go to root folder
cd ../..

# Generate http-client interfaces
yarn codegen

# Start Mercur
yarn dev

 

Resources

Learn more about Mercur

Learn more about Medusa

About

JavaScript Open Source
Multi-Vendor Marketplace Accelerator build on top of Medusa.js. Mercur simplifies the path to your own customized, multi-vendor marketplace.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published