Surface
/dashboard portalSeller PortalIndependent storefront workspace: banners, business info, and policies per seller.
Multi-tier pricing, SKU tracking, low-stock alerts, and bulk import.
Verification, packing slips, dispatch handover, and tracking updates.
Commission breakdown per item and one-click withdrawal requests.
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.
Catalog
Variants + CSV uploadsFull controlMoney
Settlements & withdrawalsTransparent01 / 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.
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 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.
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
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.
Two Flutter clients ship alongside: the customer app and the seller app. Both talk to the same versioned API described in this document.
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.
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.
https://your-domain.com/api/v113 / 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.
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
| Module | Route | Capabilities |
|---|---|---|
| Overview | /dashboard | High-level store performance, revenue charts, and quota indicators. |
| Manage Products | /dashboard/products | Full catalog CRUD, attribute variations, digital asset uploads, and bundle manager. |
| Media Library | /dashboard/media | Dedicated seller image and document repository scoped to the merchant. |
| Manage Orders | /dashboard/orders | Order status updates, customer delivery info, and 1-click digital delivery dispatch. |
| Delivery & Pickup | /dashboard/delivery | Operational delivery tracking and shipping partner handoffs. |
| Direct Messaging | /dashboard/messages | Real-time peer-to-peer customer chat powered by Ably channels. |
| Settlements & Ledger | /dashboard/settlements | Itemized commissions, sales ledger, and CSV financial exports. |
| Withdrawals | /dashboard/withdrawals | Payout requests to bank accounts or payment channels against system minimum thresholds. |
| Store Followers | /dashboard/followers | Customer audience engagement and broadcast conversation initiator. |
| Packages | /dashboard/packages | Tiered seller membership upgrades with listing quotas and commission discounts. |
| AI Credits | /dashboard/ai-credits | Credit pack purchases for AI description generation and automated translations. |
| Store Settings | /dashboard/settings | Store 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 triggersorders.digital-deliver. - The system mints a
DigitalEntitlementrecord 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:
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:
- 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. - 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). - Wait for admin approval.
The marketplace owner reviews the application under Admin → Sellers and approves the store (
seller.approved). Until both checks pass, theauth:sellerguard refuses dashboard access — a rejected seller sees the exact reason on the sign-in screen. - Sign in and land on the overview.
After approval, sign in at
your-domain.com/seller; the dashboard at/dashboardopens with net earnings, order volume, live products, and the AI quota meter. - 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. - 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
| Module | Route | What you do there |
|---|---|---|
| Products | /dashboard/products | Create simple and variable products; the attribute matrix generates every size/color/fabric combination with its own SKU, stock, and pricing. |
| Categories | /dashboard/categories | Browse the platform taxonomy and request a new category when your niche is missing — requests go to admin review. |
| Brands | /dashboard/brands | Register custom brand names for your products, also subject to admin review. |
| Attributes | /dashboard/attributes | Manage the attribute sets (size, color, fabric…) that power product variation matrices. |
| Product FAQs | /dashboard/faqs | Add 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-bundles | Group complementary products into discounted bundles with inventory validation. |
| Media | /dashboard/media | Your private image and document library; everything uploaded here is scoped to your store only. |
Orders & delivery
| Module | Route | What you do there |
|---|---|---|
| Manage Orders | /dashboard/orders | Process orders, update statuses, view customer delivery info, and trigger 1-click digital delivery for downloadable goods. |
| Delivery → Requests | /dashboard/delivery/requests | Create 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/requests | Create 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/history | Every past pickup and shipment with its current state. |
| Delivery → Tracking | /dashboard/delivery/tracking | Live 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.