Scalable Marketplace Starter for B2C

by rigby

This Starter offers a full marketplace platform. Ships with a storefront, marketplace admin, and vendor dashboards along with features like split cart commissions, support chats, and more.

Built by

rigby

Type

B2C Marketplace

View Demo View on GitHub

B2C Storefront
for Mercur - Open Source Marketplace Platform

🛍️ B2C Marketplace Storefront Demo · Mercur Website · 📃 Explore the docs

B2C Storefront for Marketplace

Customizable storefront designed for B2C with all elements including browsing and buying products across multiple vendors at once.

Ready to go:

Home Page - 🛍️ Check demo
Listing
Product Page
Shopping Cart
Seller Page
Selling Hub - Moved to external VendorPanel
Wishlist

Part of Mercur

Mercur is an open source marketplace platform that allows you to create high-quality experiences for shoppers and vendors while having the most popular Open Source commerce platform MedusaJS as a foundation.

Mercur is a platform to start, customize, manage, and scale your marketplace for every business model with a modern technology stack.

Quickstart

Installation

Clone the repository

git clone https://github.com/mercurjs/b2c-marketplace-storefront.git

Go to directory

cd b2c-marketplace-storefront

Install dependencies

yarn install

Make a .env.local file and copy the code below

1# API URL
2MEDUSA_BACKEND_URL=http://localhost:9000
3# Your publishable key generated in mercur admin panel
4NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY=
5# Your public url
6NEXT_PUBLIC_BASE_URL=http://localhost:3000
7# Default region
8NEXT_PUBLIC_DEFAULT_REGION=pl
9# Stripe payment key. It can be random string, don't leave it empty.
10NEXT_PUBLIC_STRIPE_KEY=supersecret
11# Backend cookie secret
12REVALIDATE_SECRET=supersecret
13# Your site name in metadata
14NEXT_PUBLIC_SITE_NAME="Fleek Marketplace"
15# Your site description in metadata
16NEXT_PUBLIC_SITE_DESCRIPTION="Fleek Markeplace"
17# Algolia Application ID
18NEXT_PUBLIC_ALGOLIA_ID=supersecret
19# Algolia Search API Key
20NEXT_PUBLIC_ALGOLIA_SEARCH_KEY=supersecret
21#TalkJS APP ID
22NEXT_PUBLIC_TALKJS_APP_ID=<your talkjs app id>

Start storefront

yarn dev

Guides

How to get Aloglia Keys

How to get TalkJs App ID

Configure Algolia index

To work Algolia correctly you need to configure facets and searchable attributes. You can use import function to upload algolia-config.json file

In Algolia dashboard chose your index and select Import configuration from Manage index dropdown menu

algolia-config.json

1{
"settings": {
  "minWordSizefor1Typo": 4,
  "minWordSizefor2Typos": 8,
  "hitsPerPage": 20,
  "maxValuesPerFacet": 100,
  "searchableAttributes": [
    "title",
    "subtitle",
    "brand.name",
    "tags.value",
    "type.value",
    "categories.name",
    "collection.title",
    "variants.title"
  ],
  "numericAttributesToIndex": null,
  "attributesToRetrieve": null,
  "unretrievableAttributes": null,
  "optionalWords": null,
  "attributesForFaceting": [
    "average_rating",
    "filterOnly(categories.id)",
    "categories.name",
    "seller.handle",
    "seller.store_status",
    "filterOnly(supported_countries)",
    "searchable(title)",
    "variants.color",
    "variants.condition",
    "variants.prices.currency_code",
    "variants.size"
  ],
  "attributesToSnippet": null,
  "attributesToHighlight": null,
  "paginationLimitedTo": 1000,
  "attributeForDistinct": null,
  "exactOnSingleWordQuery": "attribute",
  "ranking": [
    "typo",
    "geo",
    "words",
    "filters",
    "proximity",
    "attribute",
    "exact",
    "custom"
  ],
  "customRanking": null,
  "separatorsToIndex": "",
  "removeWordsIfNoResults": "none",
  "queryType": "prefixLast",
  "highlightPreTag": "<em>",
  "highlightPostTag": "</em>",
  "alternativesAsExact": ["ignorePlurals", "singleWordSynonym"],
  "renderingContent": {
    "facetOrdering": {
      "facets": {
        "order": ["variants.color", "variants.size", "variants.condition"]
      },
      "values": {
        "variants.color": {
          "sortRemainingBy": "count"
        },
        "variants.condition": {
          "sortRemainingBy": "count"
        },
        "variants.size": {
          "sortRemainingBy": "count"
        }
      }
    }
  }
},
"rules": [],
"synonyms": []
77}