MainMarket Features Documentation for MainMarket

Functional Features (Customer & Store Operations)

1. Product Discovery and Shopping Experience

Product Quick View

Allows customers to preview product information in a popup or modal without leaving the current page. Users can instantly see product images, name, price, available variations, short description, ratings, and add-to-cart options. This improves browsing speed and convenience, especially when comparing multiple products.

Advanced Product Filtering and Search

Filtering options include category, brand, price range, size, color, rating, availability, vendor, tags, and other product attributes. Advanced search includes keyword search, instant suggestions, autocomplete, typo tolerance, and result sorting by relevance, popularity, price, newest, or rating.

Cart and Wishlist Functionality

The cart system allows users to add products, update quantities, remove items, review totals, apply coupons, and proceed to checkout. The wishlist feature lets customers

save products for later purchase, increasing return visits and future conversions.

Product Reviews and Ratings

Customers can leave star ratings and written reviews. Reviews help other shoppers make informed buying decisions about product quality, sizing, durability, value, and performance. The review system may include moderation, verified purchase labeling, image uploads, helpful vote counts, and sorting options.

Coupon and Discount System

Store owners can create promotional offers including percentage discounts, fixed-amount discounts, free shipping, category-based promotions, minimum cart value discounts, first-time customer offers, or limited-time campaigns. Supports coupon codes entered at checkout and automatically applied promotions.

Integrated Payment Gateways

Supports secure online payments including credit/debit cards, digital wallets, regional payment systems, bank transfers, or cash-on-delivery options. Ensures a smooth checkout experience, secure transaction handling, and compatibility with different markets.

2. Customer Accounts and Order Management

User Authentication and Profile Management

Customers can create accounts, log in securely, manage personal information, and access shopping history. Authentication includes email/password login, social login, password reset, and session management. Profile management allows users to update name, phone number, email, shipping addresses, billing details, saved payment preferences, and account settings.

Order Tracking and Management

Customers can view order history and check status (pending, confirmed, packed, shipped, delivered, or canceled). Features include shipment tracking numbers, estimated delivery dates, invoice access, and reorder options.

3. Marketplace and Global Reach

Multi-vendor Marketplace Support

Supports multiple sellers within the same website. Each vendor can manage their own products, pricing, stock, storefront information, and order processing. Customers browse products from different sellers in one place, while admins manage vendor approvals, commissions, payouts, and marketplace rules.

4. Admin and Store Operations 4.1 Shop Management

The shop feature is central to the multi-vendor marketplace and operates differently based on user roles.

Super Admin Shop Controls

The super admin has supreme authority over all shops in the application. Key capabilities include:

  • ●  Viewing all published and inactive shops across the platform.
  • ●  Setting a commission rate for a shop during the approval process.
  • ●  Controlling shop approval and disapproval actions.
  • ●  Accessing every shop’s own dashboard and inner pages.

● Operating as a vendor themselves, including listing their own shop and controlling it from a vendor perspective.

Vendor Shop Management

Vendors are the shop owners. A vendor can register as a seller and open a shop based on an agreement with the super admin. Vendor capabilities include:

  • ●  Listing their own products.
  • ●  Assigning staff members to their shop.
  • ●  Monitoring their orders and updating order statuses (super admin handles

    subsequent actions).

  • ●  Setting shop-specific FAQs (e.g., a grocery shop’s FAQ differs from a gadget

    shop’s).

  • ●  Setting shop-specific Terms & Conditions if permitted by the super admin.

    Staff Role in Shops

    Staff are assigned by vendors and act as support personnel with limited permissions:

  • ●  A staff member has access only to the shop to which they are assigned (no cross-shop access).
  • ●  Staff can add FAQs to their assigned shop.

    4.2 Product Management

    Products are the core components of the site, representing items or services available for sale. Admins add products to populate the ecommerce platform, providing a diverse range of options to attract and engage a wider audience.

    Super Admin Product Overview

The super admin can check all listed products on the site, including the ability to view all low-stock and out-of-stock products across all shops. This allows the admin to contact shop owners about their product inventory.

Within the product list, the admin can sort products by Name (alphabetical), Price/Unit (lowest to highest or vice versa), Quantity (stock level), and Status (published or draft). The admin can also search for specific products using keywords and filter products by group or category.

Product Form (Super Admin & Vendor)

When adding or editing a product, the following fields and sections are available:

  • ●  Product Featured Image : The primary visual representation of a product, prominently displayed on the product detail page.
  • ●  Product Image Gallery : A collection of additional images showcasing the product from various angles or variations.
  • ●  Video Link Input Field : A space for users to enter video links for product demonstrations. Individual videos can be removed, and an Add Video button permits multiple video links.
  • ●  Groups : High-level categories that classify products into distinct themes or collections (e.g., grocery, bakery, clothing, bags, makeup, daily needs).
  • ●  Categories : Subcategories displayed based on the selected group (e.g., for “grocery”: fruit & vegetables, meat, fish, dairy).
  • ●  Authors : The creators of books or literary works associated with a product.
  • ●  Manufacturer : The entity responsible for producing the product.
  • ●  Tags : Descriptive keywords or labels for search and categorization.
  • ●  Name : The unique title or identifier for the product.
  • ●  Slug : A URL-friendly version of the product name for SEO.
  • ●  Unit : The measurement or quantity associated with the product (e.g., per

    kilogram, piece, liter).

  • ●  Description : Detailed text about the product’s features, benefits, and

    specifications.

  • ●  Status : Indicates whether the product is “published” (available to customers) or

    in “draft” mode.
    Product Type: Simple vs. Variable

  • ●  Simple Product : Each item is identical without multiple variations. Fields include:
    • ○  Price : The regular cost of the product.
    • ○  Sale Price : The temporarily reduced price during promotions.
    • ○  Quantity : The number of available units in stock.
    • ○  SKU : A unique identifier for inventory management.
    • ○  Width, Height, Length : Physical dimensions for shipping calculations.
    • ○  Is Digital : Indicates a downloadable file or digital service.
    • ○  Is External : Indicates an affiliate or externally linked product.
  • ●  Variable Product : Offers various options (size, color, style). Fields include:
    • ○  Add Option : A button to add additional variations, revealing Attribute

      Name (e.g., Size) and Attribute Value (e.g., Small) fields.

    • ○  Each attribute option can be individually removed.
    • ○  Variations can have their own price or characteristics.

      Vendor Product Management

      Administrators keep control of the platform while enabling merchants to manage their product listings. Admins can edit and delete any product but are not permitted to add

products. To add a product, vendors must log in to their own dashboards, visit their particular store, and use the Add Product button.

4.3 Product Groups

“Groups” are overarching thematic collections that encompass a range of related categories and products. They serve as high-level categories that help customers quickly identify and access products aligned with their interests. Groups simplify navigation, facilitate effective merchandising, and allow admins to highlight specific product collections.

Examples include:

  • ●  Grocery : Categories like canned goods, spices, and beverages.
  • ●  Bakery : Categories like bread, pastries, and cakes.
  • ●  Daily Needs : Categories like cleaning supplies, personal care, and health

    products.

  • ●  Furniture : Categories like living room, bedroom, and office furniture.

    Super Admin Group Management

    The super admin can add, remove, modify, search, and sort groups. When adding or editing a group, the following fields are available:

  • ●  Name : The thematic collection name.
  • ●  Slug : A URL-friendly version.
  • ●  Select Icon : An icon that visually represents the group.
  • ●  Select Layout : Display style (e.g., grid or list view).
  • ●  Select Product Card : Template for displaying product information within the

    group.

● Upload Promotional Sliders : Banners or sliders to highlight featured products or offers. Each banner includes a Title, Description, and Banner Image, with an option to remove.

4.4 Product Categories

Categories are distinct, organized groupings of related products used to classify similar items together. For example, within a “Book” group, categories might include Thriller, Fiction, Horror, Children’s Literature, Novels, Romantic Poetry, and Comic Books.

Super Admin Category Management

The super admin can add, remove, modify, search, and filter categories by group. When adding or editing a category, the following fields are available:

  • ●  Image : A visual representation of the category.
  • ●  Name : The primary identifier for the category.
  • ●  Slug : A URL-friendly version.
  • ●  Details : Additional information about the category.
  • ●  Select Icon : An icon symbolizing the category.
  • ●  Types : The type of category (e.g., Grocery, Clothing).
  • ●  Parent Category : For hierarchical relationships, select a parent category.

    4.5 Product Tags

    Tags are descriptive keywords or labels assigned to products to enhance searchability and improve user navigation. Tags categorize items based on attributes like size, color, type, and more, leading to a smoother shopping experience and easier inventory management.

Super Admin Tag Management

The super admin can add, remove, modify, and search tags. When adding or editing a tag, the following fields are available:

  • ●  Image : A visual reference for the tag.
  • ●  Name : The main identifier for the tag.
  • ●  Slug : A URL-friendly version.
  • ●  Details : Purpose or characteristics of the tag.
  • ●  Select Icon : An icon for quick recognition.
  • ●  Type : The category of the tag (e.g., category, color, material).

    4.6 Product Attributes

    Attributes are characteristics or features of a product that can vary or be customized by the customer, such as size, color, or material. They help describe and differentiate products, allowing customers to select and customize products according to their preferences.

    Super Admin vs. Vendor Access

  • ●  Super Admin : Has no access to add attributes. Admins can only edit or delete existing attributes (name, values, meta) but cannot create new ones.
  • ●  Vendor : Only vendors can add attributes to the system. Vendors log in to their own dashboards and visit their store to add product attributes. This allows merchants to provide detailed information about their items while administrators maintain platform control.

    When editing an attribute, the fields include Name, Values (with optional Meta for additional details like measurement units), and options to Add Value or Remove existing

values.

4.7 Product Manufacturers / Publications

Manufacturer or publication information provides customers with transparency about product origins, building trust and credibility. These details offer insights into product quality and authenticity.

Super Admin Management
The super admin can add, remove, modify, and search manufacturers/publications. Fields include:

  • ●  Logo : For brand recognition.
  • ●  Cover Image : Reflecting the entity’s identity.
  • ●  Name : Official name.
  • ●  Slug : URL-friendly version.
  • ●  Website : Direct link to more information.
  • ●  Description : Key features or values (AI generation available).
  • ●  Groups : Relevant shop groups for categorization.
  • ●  Social Profiles : Platform selection and URL input for direct customer

    connections.

    Vendor Management

    Admins can edit, delete, and add any manufacturer/publication. Vendors can only add manufacturers/publications for a particular shop. To add a publication, vendors log in to their dashboard, visit their store, and use the Add Manufacturer/Publication button.

    4.8 Product Authors

Authors are the individuals who created the content for books available on the platform. Their information (image, name, biography, date of birth, date of death) helps customers understand the background and expertise of the authors, adding a personal touch to the shopping experience.

Super Admin Author Management

The super admin can search, add, remove, and modify authors. Fields include:

  • ●  Image : Representative photo.
  • ●  Cover Image : Encapsulating the author’s style.
  • ●  Name : Full name.
  • ●  Slug : URL-friendly version.
  • ●  Languages : Languages in which the author’s works are available.
  • ●  Bio : A concise biography.
  • ●  Quote : A compelling quote from the author.
  • ●  Born : Date of birth.
  • ●  Death : Date of death (if applicable).
  • ●  Social Profiles : Platform selection and URL input.

    Vendor Author Management

    Admins can edit, delete, and add any author. Vendors can only add authors for a particular shop. Vendors log in to their dashboard, visit their store, and use the Add Author button.

    4.9 Product Export / Import

    Export and Import functionality works under a specific shop. The process differs for simple and variable products.

Simple Products

  • ●  Export : Go to Your Shop → Products, click the three dots, and export the simple products data.
  • ●  Import : From the same location, import the exported CSV file. Variable Products

    For variable products, three separate CSV files are required:

    1. AttributesCSV
    2. ProductsCSV
    3. VariationOptionsCSV

    The import process must follow this order:

    1. ImportAttributes(first)
    2. ImportProducts(second) 3. ImportVariations(third)

    Note : type_id refers to the group ID (e.g., Grocery or Clothing ID). Type information can be obtained from the api_url/types URL.

    4.10 Inventory and Stock Management

    The inventory route allows the super admin to easily check the product inventory status across all shops, helping maintain a healthy product supply flow. The super admin can view low-stock and out-of-stock products for all listed shops and contact shop owners about their inventory needs.

    5. Order Management

An order represents a customer’s request to purchase one or more products after providing shipping, payment information, and confirming the purchase.

Super Admin Order Management

The super admin can access all orders, sort them by total amount or order date, search by tracking number, and filter by status. Order status options include:

  • ●  Pending
  • ●  Processing
  • ●  At Local Facility
  • ●  Out for Delivery
  • ●  Completed
  • ●  Cancelled

    For each order, the admin can:

  • ●  Change Status : Update the order’s progress.
  • ●  Export Orders : Generate and save order data as CSV or Excel.
  • ●  Download Invoice : Retrieve the order’s invoice as a PDF.

    Vendor Order Management
    Vendors can manage the status of orders for their specific shop. To do so, the vendor logs in, navigates to the “Orders” section, clicks on a specific order, reviews the details, changes the status, and clicks Save Changes to record the action. This allows vendors to maintain transparent communication with customers.

    6. Analytics and Reporting Basic Summary

Quick overview of important metrics including total orders, total sales, total customers, total products, or other KPIs depending on backend setup.

Order Status Widgets

Displays number of orders in different stages (pending, processing, shipped, delivered, or canceled) to monitor fulfillment progress and identify bottlenecks.

Recent Orders

Shows the latest orders placed on the platform for real-time monitoring and quick response.

Sales History

Visual or tabular view of sales performance over time to track revenue trends, seasonal demand, and promotion effectiveness.

Popular Products

Highlights products performing well based on sales, engagement, or customer interest to support inventory planning and merchandising.

Low Stock Products

Identifies items running out of inventory to prevent stockouts and missed sales opportunities.

Top 10 Most Rated Products

Shows products with the highest number of customer ratings to identify trusted items for promotional campaigns.

Top 10 Categories with Most Products

Provides overview of catalog distribution to improve category structure and balance

inventory.

Recent Withdrawal

For marketplace stores, displays latest vendor withdrawal requests or payout activities to monitor vendor payment flow.

Technical & Architectural Features

7. Core Technology and Architecture

Built with React and Next.js

The store uses a modern frontend stack that is fast, scalable, and easy to maintain. React enables reusable UI components (product cards, banners, category sections, filters, carts, forms). Next.js adds server-side rendering, static generation, file-based routing, image optimization, code splitting, and better performance.

REST API Support

Connects to backend services using either REST APIs. REST is useful for traditional eCommerce platforms.

Easy Customization with Modular Components

Structured using reusable, independent components, making it easy to modify, extend, or rearrange features without affecting the entire system. Product sections, banners, sliders, category blocks, header styles, footers, and cards can be updated individually.

SEO Optimized

Includes clean URLs, fast loading speed, optimized metadata, proper heading structure, image optimization, schema markup, mobile-friendly design, and support for server-side rendering or static generation through Next.js.

8. Design and User Experience

Modern, Clean, and Responsive Design

Professional and visually appealing design using current UI patterns, balanced spacing, elegant typography, clear call-to-action buttons, and polished product presentation. Responsive interface automatically adapts to desktops, tablets, and smartphones.

Multiple Homepage Layouts

More than one homepage design allowing store owners to choose a layout matching their brand, product type, or audience. Layouts differ in banner sections, category displays, featured products, promotional blocks, deal sections, and brand showcases.

Dark and Light Mode

Users can switch between dark and light visual themes based on preference or device settings. Consistent colors, contrast, readability, and branding across both modes.

Mobile Optimized and Fully Responsive

Touch-friendly buttons, swipeable product galleries, easy-to-use menus, optimized checkout forms, fast loading performance, and layouts comfortable on small screens.

Mobile users can browse, search, add to cart, and complete purchases with minimal friction.