SELLER / 01 Store
Branding & Policies

Independent storefront workspace: banners, business info, and policies per seller.

SELLER / 02 Catalog
Variants + CSV Upload

Multi-tier pricing, SKU tracking, low-stock alerts, and bulk import.

SELLER / 03 Orders
Fulfillment Pipeline

Verification, packing slips, dispatch handover, and tracking updates.

SELLER / 04 Money
Settlements & Wallet

Commission breakdown per item and one-click withdrawal requests.

Seller portal documentationSell · Manage · Get paid

Web portal

Mono. Seller Portal.

The seller web workspace, end to end.

The seller web portal served at /dashboard: brand your store, build the catalog with variants and bulk CSV uploads, run the order fulfillment pipeline, and manage settlements, wallet, and withdrawals.

A / 01

Surface

/dashboard portalSeller Portal
A / 02

Catalog

Variants + CSV uploadsFull control
A / 03

Money

Settlements & withdrawalsTransparent

01 / Overview

One codebase, three front doors

MONO Marketplace is a multi-seller commerce platform. A single Laravel application serves three completely separate front doors, and they all share one database, one permission system, and one theme engine.

STOREFRONT

Customer website

  • Themeable catalog with nine shipped storefront themes.
  • Cart, coupons, vouchers, wishlist, loyalty, and wallet.
  • Fourteen payment methods including cash on delivery and bank transfer.
  • Digital goods, bundles, and seller chat with realtime delivery.
SELLER PANEL

Seller dashboard

  • Applications, product, bundle, and taxonomy management.
  • Order fulfilment with per-item digital delivery.
  • Settlements, withdrawal requests, subscription packages.
  • AI suite with metered text, translation, and image quotas.
ADMIN PANEL

Platform control

  • Orders, invoices, refunds, and a full finance ledger.
  • Seller approvals, subscriptions, payouts, and delivery operations.
  • Roles, permissions, languages, media, and site settings.
  • Push broadcasting, newsletters, and an AI administration toolset.

What ships in the package

Storefront themes

Nine themes on disk: mono (built in), plus beauty, electronics, fashion, fullwidth, grocery, home, petshop, and sports. Each is a self-contained package with its own views, assets, palette, and optional database tables.

Mobile applications

Two Flutter clients ship alongside: the customer app and the seller app. Both talk to the same versioned API described in this document.

Web installer

public/install.php is a self-contained wizard that creates the database, writes the environment file, creates the first administrator, and activates a theme. No Composer, Node, or shell access is required on the host.

The three front doors, at a glance

Each interface is purpose-built for desktop web workflows — responsive Blade templates styled with Tailwind CSS, with zero client-side compilation steps.

Storefront — Customer web marketplace
Seller Panel — Seller dashboard & catalog
Admin Panel — Platform operations control

Who this documentation is for

This guide covers the web product: the storefront, the seller panel, the admin panel, and the backend services that support them. The two Flutter applications have their own companion documents. Everything here is written against the shipped source, so route names, table names, and permission keys match what you will find in the package.

API PREFIXhttps://your-domain.com/api/v1

13 / Seller panel

Seller dashboard and store operations

Live Seller Panel Demo ↗

The seller portal is served from /dashboard (on your domain: https://your-domain.com/seller) behind the auth:seller guard, seller.verified, and seller.approved middleware. Each seller operates inside an isolated tenancy boundary: every query is scoped to seller_id, so merchants only ever see and manage their own store catalog, orders, media, and finances.

Seller Dashboard — seller KPIs, real-time revenue trend, AI quotas, and quick actions

Dashboard metrics

The landing page provides immediate operational visibility for merchants:

  • Net Earnings (30d): Net income from paid, fulfilled items minus marketplace commission and refunds.
  • Order Volume: Total order count with monthly delta comparisons.
  • Average Order Value (AOV): Average transaction spend across store orders.
  • Live Products: Published catalog count with inventory growth metrics.
  • AI Usage & Quotas: Real-time consumption meter for text generation tokens, translation tokens, and generated product imagery. Displays clear status indicators when allowances are reached.
  • 12-Week Revenue Trajectory: Rolling financial bar chart plotting sales momentum.
  • Top Products Leaderboard: Top 5 revenue-generating items in the seller's catalog.

Seller portal navigation

ModuleRouteCapabilities
Overview/dashboardHigh-level store performance, revenue charts, and quota indicators.
Manage Products/dashboard/productsFull catalog CRUD, attribute variations, digital asset uploads, and bundle manager.
Media Library/dashboard/mediaDedicated seller image and document repository scoped to the merchant.
Manage Orders/dashboard/ordersOrder status updates, customer delivery info, and 1-click digital delivery dispatch.
Delivery & Pickup/dashboard/deliveryOperational delivery tracking and shipping partner handoffs.
Direct Messaging/dashboard/messagesReal-time peer-to-peer customer chat powered by Ably channels.
Settlements & Ledger/dashboard/settlementsItemized commissions, sales ledger, and CSV financial exports.
Withdrawals/dashboard/withdrawalsPayout requests to bank accounts or payment channels against system minimum thresholds.
Store Followers/dashboard/followersCustomer audience engagement and broadcast conversation initiator.
Packages/dashboard/packagesTiered seller membership upgrades with listing quotas and commission discounts.
AI Credits/dashboard/ai-creditsCredit pack purchases for AI description generation and automated translations.
Store Settings/dashboard/settingsStore name, banner, logo, business address, and payment preferences.

14 / Seller panel

Products, digital fulfilment, settlements, and AI

Sellers manage their complete ecommerce lifecycle from the web dashboard, supporting physical goods with complex variations as well as instantly deliverable digital goods.

Catalog and variations

Product creation in DashboardController handles both simple and variable products. Variable products synchronize attribute combinations (sizes, colors, fabrics) using VariationSyncService:

  • Each variation has its own SKU, inventory stock, regular price, and sale price.
  • Dynamic matrix creation generates all valid permutations without manual database configuration.
  • Sellers can request new categories (/dashboard/categories/request) or register custom brand names (/dashboard/brands) subject to admin review.

Product bundles

The bundle editor at /dashboard/product-bundles lets sellers group complementary products into discounted bundle packages. ProductBundleController validates inventory across all bundle items and ensures accurate pricing on checkout.

Digital goods & instant delivery

Products marked is_digital support downloadable files, license keys, and digital entitlements. When an order is placed and paid:

  • The seller accesses /dashboard/orders/{order} and triggers orders.digital-deliver.
  • The system mints a DigitalEntitlement record with access limits and secure download tokens.
  • The customer immediately receives download access in their account library and via email notification.

Settlements and withdrawals

Every completed sale generates a settlement row calculating the exact revenue breakdown:

Settlement Equation: Net Seller Payout = Item Subtotal - Platform Commission + Tax (if seller-collected)

The settlements table at /dashboard/settlements tracks pending, available, and paid earnings. Sellers request payouts via /dashboard/withdrawals once their balance satisfies the minimum withdrawal threshold configured in platform settings.

Featured sponsorships

Sellers can promote individual products to prime homepage and category slots via /dashboard/products/{product}/feature. The seller chooses a featured duration package and completes payment directly in the panel using Stripe, SSLCommerz, or PayPal. Upon payment verification, the product is flagged is_featured = 1 until the expiration timestamp.

Seller AI suite

The dashboard incorporates integrated AI tooling powered by OpenAI / Google Gemini providers:

  • Product Description Writer: Generates compelling ecommerce copy and bullet points from minimal attribute inputs.
  • Multilingual Translation: 1-click translation of titles and descriptions across English, Arabic, and Bengali.
  • Credit Packs: When monthly package quotas are exhausted, merchants purchase non-expiring AI credit packs directly through /dashboard/ai-credits.

15 / Seller panel

Becoming a seller: from sign-up to first sale

New merchants join without any admin-side work: registration, document verification, and approval are all handled through the storefront and the seller portal. This is the exact path a new seller walks:

  1. Open a store.

    On the seller portal sign-in page (your-domain.com/seller), click Open a store. The multi-step registration asks for the store name, contact details, and the owner's account credentials.

  2. Submit verification documents (KYC).

    Depending on the platform's onboarding settings, the seller uploads business/trade documents during registration or from the dashboard. The store enters the verified pending state (seller.verified).

  3. Wait for admin approval.

    The marketplace owner reviews the application under Admin → Sellers and approves the store (seller.approved). Until both checks pass, the auth:seller guard refuses dashboard access — a rejected seller sees the exact reason on the sign-in screen.

  4. Sign in and land on the overview.

    After approval, sign in at your-domain.com/seller; the dashboard at /dashboard opens with net earnings, order volume, live products, and the AI quota meter.

  5. Complete the store profile.

    Open Settings (/dashboard/settings) before adding products: upload the store logo, fill the multilingual store name and description, contact email/phone, category, and full address, then set the payout method under the Payouts tab so settlements have somewhere to go.

  6. Add products and go live.

    Create the catalog (next section), keep everything within the package listing quota, and publish. Products appear on the storefront immediately.

Trying the demo? The seller sign-in page shows a Demo seller login box with copy-and-autofill credentials. Demo mode disables write actions — you can look around every screen but nothing you click changes data.

16 / Seller panel

Every seller panel module, in detail

The sidebar in /dashboard maps one-to-one to the modules below. Each subsection covers what the module does and the fields you will actually fill in.

Catalog toolkit

ModuleRouteWhat you do there
Products/dashboard/productsCreate simple and variable products; the attribute matrix generates every size/color/fabric combination with its own SKU, stock, and pricing.
Categories/dashboard/categoriesBrowse the platform taxonomy and request a new category when your niche is missing — requests go to admin review.
Brands/dashboard/brandsRegister custom brand names for your products, also subject to admin review.
Attributes/dashboard/attributesManage the attribute sets (size, color, fabric…) that power product variation matrices.
Product FAQs/dashboard/faqsAdd question/answer pairs that appear on your product pages — buyers see these before asking in chat. Add, edit, and save rows directly.
Product bundles/dashboard/product-bundlesGroup complementary products into discounted bundles with inventory validation.
Media/dashboard/mediaYour private image and document library; everything uploaded here is scoped to your store only.

Orders & delivery

ModuleRouteWhat you do there
Manage Orders/dashboard/ordersProcess orders, update statuses, view customer delivery info, and trigger 1-click digital delivery for downloadable goods.
Delivery → Requests/dashboard/delivery/requestsCreate Delivery Request: pickup address, contact person and number, the admin warehouse to collect from, preferred pickup date/time, package quantity and weight, and notes — then submit the pickup request.
Delivery → Shipment/dashboard/delivery/requestsCreate Shipment: record the courier/delivery provider, courier name, tracking number, optional tracking URL, and estimated delivery so buyers can follow the parcel.
Delivery → History/dashboard/delivery/historyEvery past pickup and shipment with its current state.
Delivery → Tracking/dashboard/delivery/trackingLive tracking view for in-flight shipments.

Customer engagement

Inbox — real-time chat

/dashboard/messages is the seller side of the Ably-powered chat: answer pre-sale questions, negotiate, and share files. Conversations open from orders and product pages on the storefront.

Followers & broadcasts

/dashboard/followers lists the customers following your store and lets you start broadcast conversations — the direct channel for announcements and offers.

Money & growth

Settlements & withdrawals

/dashboard/settlements itemizes every sale (subtotal − commission + tax) across pending, available, and paid balances; /dashboard/withdrawals requests payouts once the platform minimum is met. Configure where the money goes under Settings → Payouts.

Packages & AI credits

/dashboard/packages shows your membership tier — listing quotas and commission discounts — and offers upgrades. /dashboard/ai-credits buys non-expiring credit packs when the monthly AI allowance runs out.

Store settings reference

/dashboard/settings has two tabs. Store profile: logo (choose from the media library or remove), store name and description in English, Arabic, and Bengali, store URL slug, contact email and phone, business category, and full location (street, country, state, city, postal code). Payouts: payout method and account details used for withdrawals. Save changes applies to the storefront immediately.