Chapter 1: Introduction, Overview & Complete Capabilities

Welcome to the definitive documentation for MartX v1.0.0 — an enterprise-grade, multipurpose Laravel 12 e-commerce platform built for high-volume digital stores, multi-niche megashops, fashion boutiques, and modern brand marketplaces.

FAST-TRACK ROADMAP

⚡ 3-Minute Quick Start Guide

Zero Terminal Commands Required

Short on time? Deploy MartX to your live server in 3 intuitive steps. No coding knowledge or command-line experience needed:

1
Upload & Extract

Upload the MartX zip package to your cPanel or server webroot (public_html) and extract all files.

Point webroot to /public
2
5-Step Web Wizard

Visit your domain in any browser. The automated installer audits PHP requirements, connects your database, and sets up your admin account.

3
Launch & Sell

Log in to your 360° Admin Dashboard, configure your store currency and payment gateways, and start processing customer orders immediately!

Ready for live transactions
Visual Flowchart: MartX Master Platform & Fulfillment Lifecycle
End-to-End Operational Journey

From the initial customer browsing session to doorstep delivery and automated stock reconciliation, MartX orchestrates a seamless 5-stage lifecycle:

Stage 1
Customer Order

Storefront Cart • 6 Payment Options

Stripe • PayPal • SSL • CoinGate • COD
Stage 2
Inventory Lock

Anti-Oversell Protection Guard

Stock Reserved for Buyer
Stage 3
Payment Verification

Instant Webhook / Advance Fee

Cryptographic Signature Pass
Stage 4
Logistics Dispatch

Courier Assignment • Slip Print

Consignment Tracking Link
Stage 5
Settlement / Release

Delivered / Auto-Release Cron

Order Completed • 0 Deadlocks
LIVE PRODUCT DEMO

Experience MartX in Real Time

Test drive both customer and merchant perspectives using our pre-configured sandbox environments. Explore full catalog management, order processing, and theme customization:

Super Admin Full Access
Pass:

All 77 permissions, payment gateways, system settings & server obfuscation.

Admin Management
Pass:

Daily store administration, merchants, financials, marketing & staff roles.

Store Manager Operations
Pass:

Catalog products, inventory matrices, order fulfillment & customer reviews.

Demo Customer Storefront
Pass:

Self-service order tracking, PDF invoice downloads, wishlist & address book.

LIVE TOUR

Experience MartX: Real-Time Architecture Tour

1 / 14
Storefront — Homepage: Hero Slider & Gemini AI Concierge
Storefront
MartX Architecture Tour MartX Architecture Tour
Click to Zoom Full HD | Hover pauses tour
1. Storefront Homepage & Gemini AI Shopping Assistant
Conversion Driver

High-converting responsive landing featuring the Summer Fashion 2026 hero slider, quick category navigation pills, trust badges (Free Shipping, 14-Day Return), and the autonomous floating Gemini AI Shopping Assistant for real-time customer concierge.

Hero Slider Gemini AI Bot Sub-50ms SSR Category Navigator

1.1 Welcome & Product Vision

MartX represents the next evolution of digital commerce software. Engineered with 2026+ web standards, it delivers sub-50ms interaction response times, predictive storefront journeys, rock-solid security architectures, and autonomous AI-assisted operations for merchants worldwide.

1.2 Author Credentials, Licensing & Support Policy

MartX is authored, engineered, and maintained by Suman Chandra Dev Sharma. Built for high-volume enterprise digital commerce, the platform is distributed under commercial marketplace licensing with guaranteed core code purity, dedicated bug resolution, and professional architectural integrity.

Lead Author & Architect Suman Chandra Dev Sharma
Direct Support Email [email protected]
Official WhatsApp Support +880 1750-527181 (Instant Chat)
GitHub Repository / Profile https://github.com/sumandev01
Software Version v1.0.0 (Enterprise Release)
Distribution Channels Authorized Commercial Marketplaces & Direct Agency Deployments
Licensing Scope

Regular License: Single domain, single commercial end-product where end-users are not charged a fee.
Extended License: Single domain application where end-users can be charged recurring subscription or access fees.

Update & Support Policy
  • Software Releases: Compatibility patches, security upgrades & version updates are provided during your active support period.
  • 6-Month Support Included: Standard 6 months of direct author support included with purchase (renewable via marketplace).
  • Perpetual Use: Your installed software license remains active on your authorized domain indefinitely.
Bug Fix Support Scope

Included: Free resolution for genuine software defects, core codebase errors, and out-of-the-box system bugs.
Excluded: Custom feature requests, user code modifications, third-party plugin conflicts, and server misconfigurations (available as paid custom services).

1.3 Core Modern Tech Stack & Architecture Audit

View Full Tech Credits & Packages (1.23)

Built without legacy bloat, MartX combines enterprise-tier backend engineering with high-velocity, lightweight frontend performance:

Laravel 12.46.x

PHP 8.2+ core, 65+ dedicated business services, 77-permission granular staff access control, and high-speed optimized route performance.

Bootstrap 5.3 & Purple UI

Mobile-first responsive storefront, Purple Admin cockpit, 5 color skins, 4 font presets, and dark/light modes.

High-Velocity JS Stack

Zero heavy SPA bloat (no cumbersome NPM compile steps needed). Battle-tested DataTables, SweetAlert2 & sub-50ms reactive AJAX interactions.

Storefront Multi-Tier Caching & Automated Catalog Sync
Sub-50ms instant response with automated background updates

MartX optimizes 90%+ of catalog loading speed. The entire public catalog, multi-column mega menus, homepage sections, and product search queries are accelerated for instant buyer browsing.

Automated Instant Catalog Sync: Whenever an administrator creates, edits, or removes products, categories, banners, or blog posts in the Admin Dashboard, the storefront updates immediately for your customers without needing manual cache clearing.
Zero-Downtime High-Traffic Protection: During massive flash sales and traffic spikes, catalog updates happen smoothly in the background without causing server slowdowns, CPU spikes, or site freezes.
Server Sizing, Concurrent Visitors & Order Throughput Benchmark Guide

Real-world performance benchmarks for MartX across different hosting environments. Thanks to efficient caching and atomic concurrency locks, even budget hosting delivers exceptional speed:

Server Tier & Hardware Cache System Daily Traffic Concurrent Visitors Order Capacity Target Business Scope
Tier 1: Entry / Shared
1 vCPU, 1–2 GB RAM
cPanel / LiteSpeed
File Cache 10K – 25K
views/day
150 – 300
live users
15 – 30
orders/min
Boutiques, local retail shops & single-brand startups (100–1,000 products).
Tier 2: Starter Cloud VPS Recommended
2 vCPU, 4 GB RAM
Hetzner / DO / Linode
Redis In-Memory 50K – 150K
views/day
800 – 1,500
live users
80 – 150
orders/min
Growing e-commerce brands running regular marketing campaigns (1,000–10,000 products).
Tier 3: High-Performance VPS
4 vCPU, 8 GB RAM
Redis + Queue Worker
Redis Cache & Queue 250K – 500K
views/day
2,500 – 5,000
live users
300 – 600
orders/min
Flash sales, seasonal promotions (Black Friday/Eid), high-density catalogs (20,000+ products).
Tier 4: Enterprise Dedicated
8+ vCPU, 16–32 GB RAM
MySQL Replica + Redis
Redis Cluster 1,000,000+
views/day
10,000+
live users
1,500+
orders/min
National retail leaders, mega multi-category storefronts & global high-frequency flash sales.
100% Full Source Code Included: MartX comes complete with all enterprise features unlocked out of the box with zero artificial limitations. The tiers above are purely recommended hosting server sizing guidelines based on your daily store traffic volume.
Cloudflare Free CDN & DDoS Shield: Connect your domain to Cloudflare (100% Free Tier) to instantly offload 60%–75% of static asset bandwidth (images, CSS, JS) to 300+ global edge locations, activate enterprise DDoS/Bot protection, and achieve sub-30ms global load speeds on any budget hosting!
Looking for third-party libraries, Composer packages, icon sets, and Google Fonts credits? View Full Tech Credits & Sources

1.4 Cloud License Verification & 14-Day Grace Period

  • Activates directly from your admin panel — no external portal, no third-party account, no complex setup.
  • Automatic domain binding upon installation with a 14-day offline grace period (the entire store remains operational if the license server is temporarily unreachable, with automatic daily retry).
  • Free, unrestricted developer testing on localhost, .test, and local IP addresses.

1.5 5-Step Web Installation Wizard (4-Marketplace Selector)

Deploy in under 3 minutes via a guided web wizard. Step 3 features 4 Marketplace Selector Cards (Authorized Marketplace, Official Store, Partner, Direct) with dynamic input switching and automated one-click database setup with demo catalog data.

1.6 In-Dashboard License Management Suite

Manage your active license, view verification status, or seamlessly transfer domains directly from the Administrative Dashboard. If migrating between domains or activating post-setup, an intuitive modal allows instant 1-click binding without reinstalling. For the complete walkthrough, explore Chapter 4: License Activation Hub.

1.7 Multi-Layered Anti-Hacking & Code Purity Shield

Prepared statements via PDO MySQL, following OWASP best practices, to prevent SQL injection attacks. Multi-layered defense against malicious script execution, unauthorized fake requests, and military-grade encrypted password hashing for maximum buyer and administrative account security.

1.8 Login Rate Limiting & Brute-Force Lockout Policy

Defends against bot password guessing. After 5 failed attempts within 60 seconds, the IP address and target account are subjected to an automated 30-minute penalty lockout.

1.9 Anti-Tampering Server-Side Price Calculation

Any attempt by dishonest buyers to manipulate product prices in their browser (such as attempting to change \$100 to \$1 via inspect tools) is strictly blocked. All product prices, variant surcharges, coupon discounts, and shipping rates are strictly verified and recalculated automatically by an automated secure server-side pricing engine.

1.10 Super Admin Security & Admin URL Obfuscation

Admin Navigation: Admin Sidebar → Administration & Settings → System Settings → "Security & 2FA" (Tab)

Protect your store against automated bot sweeps and brute-force password guessing by relocating the default admin login path to your own custom secret URL (e.g. secret-portal or control-hub) directly from the Security Settings tab.

Automated Team Sync & Email Dispatch

Changing your administrative URL automatically refreshes the routing system and sends an instant security notification email to all registered administrators containing the new secure sign-in link, ensuring no staff member gets locked out.

Reserved System Path Protection

The security validator automatically prevents you from selecting essential storefront paths (such as login, register, cart, checkout, shop, or blog) ensuring your public store continues running smoothly without conflicts.

1.11 Two-Factor Authentication (2FA) & 5 Emergency Recovery Codes

MartX delivers enterprise-grade multi-factor security for administrator accounts, pairing real-time email verification with cryptographically secure emergency bypass mechanisms:

6-Digit Email OTP Challenge

When 2FA is activated, every administrative sign-in requires a dynamic 6-digit one-time verification code dispatched directly to your authorized administrator email address with an automated security expiry timer.

Mandatory SMTP Handshake

To prevent accidental administrator lockout due to invalid mail configurations, 2FA cannot be toggled on without successfully passing an interactive live test OTP handshake.

5 Emergency Backup Codes

Generates 5 single-use emergency backup recovery codes (e.g. A1B2-C3D4) stored securely with encryption. Includes 1-click clipboard copy and text file download. In case of mailbox downtime, entering a backup code grants instant access.

Disaster Recovery: Emergency 2FA Lockdown Bypass (Database Reset)

In the rare emergency where the administrator loses access to their mailbox and has misplaced all 5 backup recovery codes, you are never locked out. As a technical administrator (via cPanel phpMyAdmin or database manager), you can instantly deactivate 2FA with zero downtime by switching the 2FA status key to 0 in the settings table.

Real-Time Emergency Reset: The authentication engine checks database status in real-time during admin sign-in. The moment the status is reset in phpMyAdmin, 2FA is immediately deactivated without requiring terminal commands or server restarts.

1.12 Dynamic Header Layouts (3 Styles) & Sticky Mobile Navigation

MartX provides 3 distinct Header Styles switchable in 1 click from the Theme Layouts Hub.
Admin Navigation: Admin Sidebar → Website & CMS → Theme Layouts → "Header Layout" (Tab):

Header Style 1 — Classic E-Commerce Comprehensive
Classic
images/header_1.png
Header Style 1 Screenshot
Header Style 1 (Classic E-Commerce Comprehensive)

Top announcement ticker (support hotline, email & multi-currency), centered brand logo, full-width categorized live search bar with AJAX auto-suggest, Dark/Light mode toggle, User Account / 1-Click Login Modal, wishlist count badge, dropdown mini-cart, and full-width main department navigation bar.

Header Style 2 — Modern Floating Capsule
Mega-Store
images/header_2.png
Header Style 2 Screenshot
Header Style 2 (Modern Floating Capsule)

Drop-shadowed rounded floating capsule bar with inline navigation, an integrated 'Categories' trigger button for the Mega Menu, click-to-expand search dropdown, Dark/Light theme switcher, and circular action pills.

Header Style 3 — Minimalist & Luxury Boutique
Luxury
images/header_3.png
Header Style 3 Screenshot
Header Style 3 (Minimalist & Luxury Boutique)

High-fashion boutique aesthetic with a centered absolute brand logo, left-aligned menu links, slide-out search drawer, minimal user profile icon, and full-screen Curtain Mega Menu.

Sticky Mobile Bottom Navigation: Touch-optimized bottom navigation bar on smartphones for quick access to Home, Shop, Categories, Wishlist, and Cart with live counter badges.

1.13 Multi-Level Category Mega Menu (2 Mega Menu Layouts)

Choose between 2 interactive Mega Menu Layouts designed for high-density catalog navigation.
Admin Navigation: Admin Sidebar → Website & CMS → Theme Layouts → "Mega Menu" (Tab):

images/mega_menu_1.png
Mega Menu Layout 1 Screenshot
Mega Menu Layout 1 (Multi-Column Grid with Promo Banner)

Multi-column category dropdown with real-time hover-switching subcategory panels, category icons, "HOT/NEW" badges, and a dedicated right-aligned promotional offer banner (Banner Position 1).

images/mega_menu_2.png
Mega Menu Layout 2 Screenshot
Mega Menu Layout 2 (Categorized Column Grid with Icon Thumbnails)

High-density multi-column catalog grid featuring circular category image/icon thumbnails, instant subcategory lists, and automatic "View All (X) →" links with fallback monograms, ideal for electronics and mega-catalog stores.

1.14 Home Page Layouts (2 Layouts) & Dynamic Section Builder

MartX includes 2 pre-designed Home Page Layouts packed with conversion-boosting dynamic sections.
Admin Navigation: Admin Sidebar → Website & CMS → Theme Layouts → "Home Layout" (Tab):

images/home_1.png
Home Layout 1 Screenshot
Home Layout 1 (Hero Slider & Full Dynamic Marketplace)

Full-width interactive hero banner slider with call-to-action buttons, 4-column store trust badges, circular category carousel, real-time ticking Flash Sale countdown, symmetrical dual offer banners, multi-tab product showcase (Featured, New, Best Sellers, Top Rated), customer reviews, brand partners, and newsletter capture.

images/home_2.png
Home Layout 2 Screenshot
Home Layout 2 (Modern Split Hero & Curated Boutique)

Asymmetrical split-screen hero layout (prominent hero banner paired with side promo cards), trending product masonry grid, curated category discovery cards, and high-conversion flash deal showcases tailored for modern fashion labels.

Complete Home Page Sections Suite
  • Hero Banner Slider: High-impact hero carousel with custom call-to-action buttons, seasonal discount tags, and background imagery.
  • Store Features / Trust Badges: Drag-and-drop reorderable trust badges (Free Shipping, 24/7 Support, 30-Day Returns, Secure Payments).
  • Dual Offer Banners: Symmetrical promotional cards (Offer 1 & Offer 2) with custom titles, discounts, and shop links.
  • Trending Categories Grid: Responsive category tiles with image thumbnails and product counters.
  • Featured & Trending Products: Multi-tab product showcase (Featured, New Arrivals, Best Sellers, Top Rated) with smooth AJAX tab switching.
  • Flash Sale with Live Countdown Timer: Real-time ticking countdown clock driving urgent impulse purchases.
  • Latest Blog & Buying Guides: Content marketing section showcasing recent articles and shopping tips.
  • Newsletter Subscription Bar: High-converting customer email capture widget syncing directly with admin newsletter subscribers.

1.15 High-Converting Product Card Engine (6 Distinct Architectural Styles)

MartX offers 6 dedicated Product Card Styles switchable store-wide from the Theme Layouts Hub. Each image below demonstrates both interactive states side-by-side — Left (On Hover State) and Right (Default State):
Admin Navigation: Admin Sidebar → Website & CMS → Theme Layouts → "Product Card" (Tab):

images/product_card_1.png
Product Card Style 1 Screenshot
Product Card Style 1 (Modern Overlay)

Left (On Hover): Card elevates 5px with drop shadow, active red wishlist heart, interactive size chips & color swatches slide in, and solid call-to-action button. Right (Default View): Clean unhovered catalog look with outline wishlist icon, -16% discount badge, running flash sale countdown timer, and outline button.

images/product_card_2.png
Product Card Style 2 Screenshot
Product Card Style 2 (Action Pills)

Left (On Hover): Image scales smoothly (1.08x) with deep elevation; circular floating action pills (Wishlist heart & One-Tap Cart) slide in from the right edge. Right (Default View): Clean product card with category badge, -16% discount tag, live flash sale timer, truncated title, and star rating.

images/product_card_3.png
Product Card Style 3 Screenshot
Product Card Style 3 (Bordered Classic)

Left (On Hover): Card elevates above the grid (Z-index 30); expandable accordion drawer drops down revealing size chips, color swatches, and full "Add to Cart" button. Right (Default View): Structured outline border, top -16% discount badge, live flash countdown timer, and centered product info.

images/product_card_4.png
Product Card Style 4 Screenshot
Product Card Style 4 (Elevated Glass)

Left (On Hover): Card lifts with soft glow; bottom frosted-glass panel (Glassmorphism) slides upward to expose variant chips and instant purchase button. Right (Default View): Edge-to-edge product photo with top live countdown timer and -16% discount tag without obstructing the image.

images/product_card_5.png
Product Card Style 5 Screenshot
Product Card Style 5 (Compact Dock)

Left (On Hover): Compact card elevates; bottom drawer expands displaying variant size chips and color swatches with circular one-tap cart icon. Right (Default View): Docked countdown timer bar, top-left -16% discount badge, and single-line compact title, price, and cart button.

images/product_card_6.png
Product Card Style 6 Screenshot
Product Card Style 6 (Luxury Editorial)

Left (On Hover): 3:4 vertical luxury photo with active heart; a full-width solid "Add to Cart" bar smoothly slides up from the bottom of the photo. Right (Default View): Minimal high-fashion presentation with top -16% badge and flash countdown timer with no visible cart button.

1.16 3 Shop Page Layouts & Faceted AJAX Live Filters

MartX includes exactly 3 Shop Page Layouts plus an interactive Grid / List View Switcher.
Admin Navigation: Admin Sidebar → Website & CMS → Theme Layouts → "Shop Layout" (Tab):

images/shop_left_sidebar.png
Shop Left Sidebar Screenshot
1. Shop Left Sidebar

Sticky vertical filter sidebar on the left (Price range slider, brand checkboxes with counts, color swatches, size buttons, rating filters) with product catalog grid on the right.

images/shop_right_sidebar.png
Shop Right Sidebar Screenshot
2. Shop Right Sidebar

Product catalog on the left with the complete faceted filter sidebar positioned on the right for alternative layout preferences.

images/shop_full_width.png
Shop Full Width Screenshot
3. Shop Full Width

Edge-to-edge 12-column responsive product grid with a collapsible top offcanvas filter drawer accessible via a dedicated "Filter" button.

Faceted AJAX Live Filters: Dual-handle Price Range Slider, Brand Checkboxes with product count badges, 5★ to 1★ Rating Stars, Color Swatch Tiles, Size/Dimension Buttons, and instant Grid/List view switching without page reloads.

1.17 WordPress-Style Reusable Central Media Library

MartX features a centralized, WordPress-inspired media management suite that completely eliminates duplicate image uploads and server storage bloat.
Admin Navigation: Admin Sidebar → Main → Media Library:

Single Upload & Universal Reuse
  • Central Media Hub: Upload your high-res banners, brand logos, product photos, and category icons into a unified library.
  • Instant Modal Media Picker: Select assets directly from modal dialogs when editing products, categories, blogs, or site settings.
  • Automated Optimization: Converts and compresses uploads into modern WebP/JPEG formats for lightning-fast page loading speeds.
  • Zero Storage Duplication: Reusing the same asset across 50 products references a single media ID in MySQL rather than creating 50 duplicate files.

1.18 Contact Inbox & AI-Powered 1-Click Direct SMTP Email Reply Suite

Customer inquiries submitted through the frontend Contact page automatically sync to the Admin Contact Message Inbox with integrated Google Gemini AI assistance.
Admin Navigation: Admin Sidebar → Customer & Community → Contact Messages:

1. Auto Inbox Sync

Inquiries (Name, Email, Phone, Subject, Message) are immediately captured with date/time stamps.

2. Gemini AI Reply Drafter

1-click AI composition analyzes inquiry context and drafts empathetic, professional emails instantly.

3. 1-Click Direct SMTP

Admins review/edit drafts and dispatch replies directly to customer inboxes without external webmail.

4. Audit Status Tracking

Messages dynamically switch between Pending and Replied badges preventing duplication.

1.19 360° Executive Admin Dashboard & Real-Time Analytics

Upon logging into the MartX administrative portal (Admin Sidebar → Main → Dashboard), store managers are greeted with an executive 6-Tier Business Intelligence Cockpit:

https://demo.getmartx.com/admin/dashboard
Purple Pro Cockpit
This Week Sales
$12,450.00
+14.2% vs Last Week
This Week Orders
324 Orders
+8.5% Growth
Active Catalog
1,250 Products
Stock Healthy
Customer Base
4,890 Users
Verified Buyers
Interactive 12-Month Area Chart + Donut Status Distribution + 6-Tier Dynamic Adaptive Masonry Stream.
Dashboard Architecture Widgets, Datasets & Real-Time Operational Functions
📅 Filter Controls Filter entire dashboard datasets across Today, Yesterday, Last 7 Days, This Month, This Year, or a Custom Date Range.
📊 Macro Charts 1. Sales Analytics Curve (8-Col Area Chart): 12-Month sales progression and revenue trend curves.
2. Order Status Breakdown (4-Col Donut Chart): Proportional share of Pending, Processing, Shipped, Delivered, and Cancelled orders.
⚡ Tier 1: Daily Activity 1. Recent Orders Stream: Live orders table with Customer Info, Amount, Payment Method, and Real-Time Status Badge.
2. Top Selling Products: Ranked listing of highest-converting catalog items with sales counts and gross revenues.
⚠️ Tier 2: Inventory Alerts 3. Out of Stock Emergency Alert: Immediate restock widget alerting managers when items reach 0 quantity.
4. Low Stock Warning Table: Threshold monitor warning before SKUs run completely out.
💡 Tier 3: Sales Intelligence 5. Top VIP Customers: Lifetime spend ranking showing high-value buyers and total orders placed.
6. Sales by Category: Department-wise volume breakdown and percentage revenue share.
7. Payment Gateway Breakdown: Transaction volume distribution across Stripe, PayPal, SSLCommerz, COD, etc.
🚚 Tier 4: Logistics & Fulfillment 8. Top Shipping Locations: Geographic distribution of customer delivery states and regions.
9. Courier Performance Tracker: Delivery speed and consignment success rates across courier partners.
🎟️ Tier 5: Campaigns & Promos 10. Active Discounted Products: Live tracker of products currently on promotional sales.
11. Active Coupons & Redemption: Real-time coupon code monitor showing usage counts vs limits.
💬 Tier 6: Customer Sentiment 12. Recent Customer Reviews: Verified 5★ buyer feedback and pending reviews needing moderation.
13. Contact Inquiries Inbox: Recent unread customer messages with 1-click reply status.

1.20 Master Settings Hub Reference (6 Core Tabs)

Centralizing store configuration with automatic tab memory, store managers can configure all vital store parameters from a unified interface.
Admin Navigation: Admin Sidebar → Administration & Settings → System Settings:

  • Basic Information: Site Title, SEO Keywords, Meta Description (3-row textarea), Store Country Selector, and Store Timezone Selector.
  • 4 Centralized Media Logos: Light Logo (1:1 contain), Dark Logo (1:1 contain), Footer Logo (1:1 contain), and Favicon via modal media selectors.
  • Contact & Footer: Public Contact Email, Phone, Physical Address, and Footer Copy text with dynamic placeholders (©, {year}, {site_title}).

  • 7 Typography Font Presets: Plus Jakarta Sans (Recommended), Inter (Modern Tech), Outfit (High-End Fashion), Poppins (Classic), Playfair Display (Editorial Luxury Serif), Urbanist (Modern Streetwear & Gen-Z), and DM Sans (Clean & Fast Minimalism).
  • 10 1-Click Color Presets: Custom Hex Colors, Vibrant Orange & Amber (#F97316), Electric Blue & Slate (#2563EB), Luxury Emerald Green (#059669), Luxury Noir / Modern Black (#111827), Royal Indigo & Violet (#6366F1), Crimson Ruby & Rose (#E11D48), Champagne Gold & Luxury (#C5A880), Nordic Ocean Teal (#0D9488), and Rose / Warm Luxury (#D19C97).
  • Dark / Light Controls: Visitor theme switcher toggle switch (allows visitors to toggle modes) and Default Mode selector (Light Mode default vs Dark Mode for first-time visitors).
  • AOS Smooth Scroll Animation: Dedicated toggle switch to enable/disable on-scroll smooth entrance animations (disabling immediately maximizes PageSpeed and reduces mobile script overhead).
  • 3-Point Live Color Pickers: Primary Brand Color, Button Background Color, and Button Text Color via interactive color picker wells with real-time Hex code reflection.
  • 5 Social Media Profiles: Facebook, Twitter (X), LinkedIn, Instagram, and YouTube URL profiles displayed dynamically across storefront header and footer.

  • Currency & Regional: Currency Symbol ($, €, £, ¥, ₹), Code (USD, EUR, GBP), Position (Left $100 vs Right 100€), Decimal Places (0 to 4), Decimal separator (.), Thousand separator (,).
  • Analytics & Tracking: Facebook Pixel ID (e-commerce catalog events) and Google Analytics 4 (GA4) Measurement ID (G-XXXXXXX).
  • Google Maps Embed: Responsive container for physical store location maps on the Contact page.

  • Interactive Collapsible Setup Guides: Step-by-step instructions for cPanel Webmail (mail.domain.com, Port 465 SSL), Gmail 16-digit App Password, and Transactional Gateways (Brevo, Resend, Mailgun on Port 587 TLS).
  • Credentials: Mail Host, Mail Port, Mail Username, Mail Password (Password Masked), Encryption (SSL/TLS), and Mail From Address.
  • Deliverability Tips: Guidance on setting up SPF and DKIM TXT records for 100% spam-free delivery.

  • Google Gemini AI Shopping Advisor: Storefront 24/7 AI chat bubble switch, free tier setup guide (zero credit card required at aistudio.google.com), AES-256 encrypted API key, and customizable AI Bot Name.
  • WhatsApp Live Agent Support: Official WhatsApp number input with country code (e.g., +8801700000000) and customizable pre-filled greeting message.

  • Admin Portal URL Prefix Obfuscation: Real-time input sanitizer with live future URL preview and 1-click URL copy button.
  • Live Handshake 2FA Email OTP: Verifies live SMTP delivery before enabling 2FA.
  • 5 Emergency Recovery Codes: Generates single-use backup recovery codes with Copy All and Download .txt features.
  • Rate Limiting Status: Enforces 5 failed attempts threshold and 30-minute lockout policy.

1.21 Payment Gateways, Unlimited Custom Roles & Codebase Architecture

Pre-integrated with 6 Core Payment Methods (+ Storefront Trust Badges Hub), an enterprise Unlimited Custom Staff RBAC Engine, and a clean, layered Laravel 12 architecture:

Stripe
Cards & Wallets
PayPal
Express Checkout
SSLCommerz
bKash & BD Cards
CoinGate
Crypto 70+ Coins
Cash on Delivery
Advance / Standard
Manual Payment
Bank Wire & TrxID
Smart Anti-Fraud Hybrid Cash on Delivery (Advance Delivery Charge System)
Eliminate fake orders and return shipping losses with configurable upfront fulfillment charge
Admin Navigation: Admin Sidebar → Ecommerce & Sales → Payment Gateways → Cash on Delivery (Click Edit)

The greatest operational risk in digital commerce merchandising is fraudulent or uncollected Cash on Delivery shipments where merchants absorb double return delivery costs. MartX eliminates this vulnerability through an intelligent Hybrid Cash on Delivery system:

1. Standard Pure COD Mode (Status: Disabled / Off): When the Advance Shipping switch is toggled OFF, customers place orders with zero upfront payment. The full gross invoice amount is collected at doorstep delivery.
2. Mandatory Upfront Delivery Charge Mode (Status: Enabled / On): When toggled ON, customers must pay the delivery/shipping charge upfront during checkout to confirm order placement, while paying the remaining product bill safely on doorstep delivery.
Omni-Channel Advance Payment Channels: Merchants easily select which gateways are permitted to receive advance shipping charges using the Allowed Advance Gateways multi-select checkboxes. Customers choose between any of the active online gateways (Stripe, PayPal, SSLCommerz, CoinGate) or Direct / Manual Payment (bKash, Nagad, Rocket, Bank Transfer with Sender Number & Transaction ID verification). The order status automatically updates to Shipping Paid with verified advance payment confirmation in the admin order list.
Unlimited Custom Staff Roles & 77 Granular Permissions
Complete delegation freedom for teams of any scale
Admin Navigation: Admin Sidebar → Administration & Settings → Roles & Permissions

Store owners are never restricted to fixed pre-defined roles. You can create unlimited custom staff roles (e.g. Store Manager, Order Fulfillment Lead, Inventory Specialist, SEO & Content Writer, Customer Support Lead, Financial Accountant) and assign exact capabilities using an intuitive checkbox matrix covering 77 granular permissions across 24 permission modules.

Automated Background Payment Sync & Fraud Shield
Zero lost orders even if buyers close their browser before return redirects execute

Traditional online stores risk dropped orders when buyers close their browser immediately after paying. MartX completely protects merchants through automated direct server-to-server payment notifications:

Cryptographic Signatures:

Payment notifications are cryptographically verified directly with gateway servers (Stripe, PayPal, SSLCommerz, CoinGate) to ensure every transaction confirmation is genuine.

Anti-Price Tampering:

Background listeners strictly compare the actual paid amount against the order grand total. Any tampered or mismatched amount is flagged immediately for merchant review.

Duplicate Order Prevention:

Automated transaction locking ensures that if a customer redirect and a background webhook notification arrive simultaneously, the order is confirmed once and only once with zero duplicates.

340+
Optimized Store Features
45
Commerce Modules & Engines
55
Auto-Managed Data Tables
65
Business Automation Services

1.22 Complete Enterprise Commerce Engine & Capabilities Suite

Beyond themes and administrative security, MartX packages 15 turnkey enterprise commerce engines designed for merchants to operate smoothly with zero coding:

1. Flash Sale & Timed Countdown Engine

Drive urgent buyer conversions with automated flash sale campaigns. Features live ticking countdown clocks, special discount badges, and automated start/end schedule activation.

Admin Navigation: Admin Sidebar → Website & CMS → Banners & Sliders & Marketing → Flash Sales
2. Multi-Attribute Variant & SKU Inventory Engine

Manage infinite combinations of product Colors and Sizes. Each variant supports independent pricing surcharges, dedicated stock counters, and unique SKU identifiers to completely eliminate over-selling.

Admin Navigation: Admin Sidebar → Ecommerce & Sales → Products → Add / Edit Product → Variants
3. Dynamic Promotions & Anti-Abuse Coupon Protection

Create percentage (%) and fixed flat ($) discount coupons. Includes automated anti-abuse protection preventing double-use during flash sales, strict per-customer usage quotas, and exclusions for already-discounted items.

Admin Navigation: Admin Sidebar → Ecommerce & Sales → Marketing → Coupons
4. Cross-Border & Incremental Shipping Engine

Configure multi-tier geographic shipping zones by country and state with Base Price + Incremental Per-Item Rates (Base + (Qty − 1) × Extra Fee). Features live checkout breakdown, anti-tampering server calculations, and AI assistant synchronization.

Admin Navigation: Admin Sidebar → Ecommerce & Sales → Shipping & Locations
5. Courier Logistics & Consignment Tracking

Assign customer fulfillment orders to delivery partners (e.g., DHL, FedEx, Pathao, Steadfast). Attach consignment tracking IDs and dispatch real-time status updates directly to buyers.

Admin Navigation: Admin Sidebar → Ecommerce & Sales → Orders → Assign Courier
6. Public Guest Order Tracking & PDF Invoices

Customers track shipments publicly without login using Order ID + Email verification. Features 1-click branded PDF invoice downloads, saved shipping addresses, and customer wishlists.

Public Access: Storefront Header & Footer → Order Tracking
7. Automated Unpaid Order Cleanup & Stock Recovery

An automated background task actively cancels abandoned payment gateway checkouts older than 35 minutes. It immediately restores reserved product inventory back to stock and repopulates the buyer's cart if they return to complete payment.

Reliability: 100% Automated Background Task (Zero stock leakage)
8. Verified Reviews & Direct Admin Public Reply

5-Star verified buyer feedback with approval moderation workflows, preventing spam reviews, along with direct administrative public reply capability shown directly on product pages.

Admin Navigation: Admin Sidebar → Customer & Community → Customer Reviews
9. Publishing Blog CMS & Social Comments

Full blogging management with high-res cover photos, SEO meta keywords, department categories, tags, and moderated reader comment discussions to build organic store traffic.

Admin Navigation: Admin Sidebar → Website & CMS → Blogs
10. Dynamic Pages & Accordion FAQ System

Create unlimited custom pages (Privacy Policy, Terms, Refund Policy) using an intuitive rich-text editor with custom SEO URLs. Includes an organized collapsible FAQ manager.

Admin Navigation: Admin Sidebar → Website & CMS → Custom Pages & FAQs
11. Brand About Page & Store Features

Showcase your store identity with brand mission statements, team member bios, social links, and 4 trust value badges (Free Shipping, 24/7 Support, Safe Payment, Money-back Guarantee).

Admin Navigation: Admin Sidebar → Website & CMS → About Page & Store Features
12. 1-Click Wishlist & Interactive Mini-Cart

Instant 1-click wishlist bookmarking with live header counter badges, dynamic dropdown mini-cart, and sub-50ms reactive cart drawer updates with zero page reloads.

Storefront: Pre-integrated across all Storefront Headers & Product Cards
13. Newsletter Engine & CSV Subscriber Export

Storefront footer newsletter capture bar with duplicate email prevention, administrative subscriber management table, and 1-click CSV subscriber list export.

Admin Navigation: Admin Sidebar → Customer & Community → Newsletter Subscribers
14. AI Customer Inquiry & Instant Email Reply Desk

Turn inquiries into buyers with Google Gemini AI. Features 1-click contextual AI response drafting, full merchant editability, direct SMTP email transmission, and automated "Replied" audit marking.

Admin Navigation: Admin Sidebar → Customer & Community → Contact Messages
15. Operational Refund Management & Audit Policy
v1.0.0 Manual Gateway Standard

MartX v1.0.0 implements an enterprise Admin-Managed Gateway Refund Standard. Store administrators maintain complete financial control by verifying return claims and executing refunds securely through payment merchant portals (Stripe Dashboard, PayPal Manager, SSLCommerz Panel). Order statuses are seamlessly updated to Cancelled with transaction reference audit trails. (Automated in-dashboard gateway refund APIs scheduled for v1.1.0 free update).

Financial Integrity: Zero accidental double-refund chargebacks Automated API Suite: Coming in v1.1.0
Enterprise Operational Control: Real-Time 1-Click Governance vs Safe-Mode Catalog Integrity
Balanced UI/UX engineering: Instant operations where speed matters, fortified validations where catalog safety is vital

High-velocity enterprise stores require rapid management responses without compromising catalog and database safety. MartX enforces a deliberate, battle-tested administrative architectural standard:

1-Click Instant Action & Moderation Desk
  • User Account Governance: Instantly Activate or Deactivate customer accounts with 1 click directly from action dropdowns without navigating away.
  • Newsletter Subscription Moderation: 1-click Unsubscribe or Re-subscribe subscriber emails directly from the subscribers table.
  • Product Reviews & Blog Comments: Real-time Approve and Reject 1-click moderation buttons right in index tables and inspect modals.
  • Live Homepage Merchandising: Product tables feature an interactive AJAX Trending Switch to promote items to the storefront curated section with 0 page reloads.
Enterprise Safe-Mode Catalog Integrity

In high-concurrency merchandising, accidental clicks on mobile or tablet devices can inadvertently deactivate best-selling products or categories, breaking live SEO indexing and causing shopping cart checkout failures.

  • Protected Catalog Models: Products, Categories, Subcategories, Blogs, and Coupons operate under Safe-Mode Governance.
  • Explicit Form Validation: Status toggles and SKU parameters are updated via verified form submissions, ensuring image relationships, SEO slugs, and relational database integrity remain 100% stable.

1.23 Credits, Frameworks & Third-Party Open-Source Libraries

MartX Enterprise is built on top of high-performance, battle-tested open-source software and permissive industry libraries. In strict compliance with global commercial software standards and permissive open-source licensing, all integrated fonts, icon collections, JavaScript plugins, and PHP Composer packages are documented below with their respective authors, roles, and official distribution licenses:

Open-Source License & IP Compliance:

All external assets and packages integrated into MartX Enterprise are distributed under permissive open-source licenses (MIT, Apache 2.0, SIL Open Font License, BSD). Zero restrictive copyleft or GPL-tainted software is utilized in the core distribution, giving commercial license holders total freedom and legal safety.

1. Fonts & Typography Engines
7 Google Fonts + 1 Local Font
Font Family Engine / Type Primary Purpose in MartX Official Source & License
Plus Jakarta Sans Google Web Font Default Storefront Typography (Clean Modern SaaS & E-Commerce) Google Fonts SIL OFL
Inter Google Web Font Documentation UI & High-Readability Storefront Preset Google Fonts SIL OFL
Outfit Google Web Font Luxury Brand & High-End Fashion Storefront Preset Google Fonts SIL OFL
Poppins Google Web Font Classic Retail & Consumer Multi-Category Preset Google Fonts SIL OFL
Playfair Display Google Web Font Editorial Luxury, Boutique & Premium Serif Preset Google Fonts SIL OFL
Urbanist Google Web Font Modern Streetwear, Electronics & Gen-Z Lifestyle Preset Google Fonts SIL OFL
DM Sans Google Web Font Minimalist Geometric Architecture Preset Google Fonts SIL OFL
Nirmala UI Bundled TrueType Font Multilingual Unicode, Bengali & Indic Characters in PDF Invoices public/fonts/Nirmala.ttf
2. Vector Icon Systems
SVG & WebFont Glyphs
Icon Collection Version / Format Application in MartX Official Source & License
Material Design Icons (MDI) v7.4.47 WebFont Administrative Cockpit, Telemetry Dashboards & Documentation Portal Pictogrammers Apache 2.0
MartX Native Vector SVG Icons (<x-icon>) Native Inline SVG Storefront Navigation, Mini-Cart, Product Cards, Customer Auth & Checkout (Themify & Flaticon retired in v1.1.0 for 0-latency rendering) In-House Engine Zero-Dependency MIT
Font Awesome 5 Free v5.10.0 WebFont Social Media Channels, Brand Logos & Footer Action Buttons Font Awesome Free License
3. Frontend JavaScript & UI Plugins
Zero-Bloat Vanilla & jQuery
Library Name Version Operational Functionality Official Source & License
Bootstrap v5.3.3 Responsive 12-Column Grid, Modals, Dropdowns, Tooltips & Offcanvas Drawers getbootstrap.com MIT
jQuery v3.7.x DOM Operations, Asynchronous AJAX Ingestion & Live Cart Updates jquery.com MIT
SweetAlert2 v11.x Animated Confirmation Dialogs, Safe Delete Modals & Floating Toast Alerts sweetalert2.github.io MIT
DataTables v1.13.x Admin Ledger Controls: Client/Server Search, Instant Column Sort & Pagination datatables.net MIT
Chart.js v4.x Executive KPI Dashboards, Real-Time Sales Velocity & Revenue Line Visualizations chartjs.org MIT
Owl Carousel 2 v2.3.4 Touch-Enabled Storefront Hero Banners & Multi-Item Product Sliders owlcarousel2 MIT
Sortable.js v1.15.x Fluid Drag-and-Drop Sequence Reordering for Mega Menus, Sliders & Team Members SortableJS MIT
NProgress.js v0.2.0 Nanoscopic Realistic Progress Bar for Seamless Storefront Page Transitions ricostacruz.com MIT
AOS (Animate On Scroll) v2.3.1 Hardware-Accelerated CSS3 Scroll Animations (Controlled via Admin Switch) michalsnik MIT
Bootstrap Datepicker v1.9.0 Order Fulfillment Date-Range Selectors & Marketing Campaign Schedulers ReadTheDocs Apache 2.0
jQuery Easing v1.4.1 Mathematical Transition Easing for Storefront Carousels & Mega Menus gsgd.co.uk BSD
4. Backend PHP Framework & Composer Packages
Laravel 12 • PHP 8.2+
Composer Package Version Constraint Core Purpose & Capability Official Source & License
laravel/framework ^12.0 The PHP Framework for Web Artisans (Service Layer Architecture, Eloquent ORM, Blade) laravel.com MIT
barryvdh/laravel-dompdf ^3.1 Automated Purchase Invoice & Packaging Slip PDF Generation with Multilingual Fonts GitHub MIT
intervention/image ^3.11 Media Manager Digital Asset Processing, Aspect Ratio Cropping & Automated WebP Encoding intervention.io MIT
spatie/laravel-permission ^6.24 Multi-Staff RBAC Security Engine with 77 Granular Permission Nodes & Direct Role Guards spatie.be MIT
laravel/socialite ^5.28 OAuth 2.0 Single-Click Customer Social Authentication (Google & Facebook) Laravel Docs MIT
propaganistas/laravel-phone ^6.0 International Phone Number Validation & Automated E.164 Country Calling Code Formatting GitHub MIT
stripe/stripe-php ^20.2 Global Credit & Debit Card Gateway with Apple Pay, Google Pay & Webhook Signatures stripe.com MIT
srmklive/paypal ^3.1 PayPal REST API v2 Express Checkout, Dynamic IPN Listeners & Smart Payment Buttons GitHub MIT
razorpay/razorpay ^2.9 Indian Domestic Payment Gateway with UPI, Netbanking & Automated Signature Verification razorpay.com MIT
coingate/coingate-php ^4.1 Global Multi-Cryptocurrency Gateway Supporting 70+ Digital Coins & Tokens coingate.com MIT
wayforpay/php-sdk ^1.0 Eastern European Domestic Gateway Integration with Real-Time Webhook Verification wayforpay.com BSD
5. Demo Media Assets, Fictional Brand Logos & Licensing Policy
100% Royalty-Free • Zero Trademark Exposure

To ensure seamless out-of-the-box staging, all demo product visuals, promotional banners, and manufacturer logos bundled within the MartX installation archive are custom-curated, AI-generated, and strictly trademark-free. This guarantees zero legal or trademark friction for software buyers, web development agencies, and commercial compliance reviewers.

AI-Assisted Visual Assets

All demo merchandise images and product photography have been synthesized using modern generative AI workflows and vector design suites. These assets are free of third-party copyright claims and are safe for demo presentations, client walkthroughs, and test environments.

100% Fictional Brand Identity

All 10 pre-seeded manufacturer brands (e.g. Apex Active, Velox Sport, Solstice Optics, Zenith Time) are entirely fictional creative concepts. MartX does not distribute proprietary corporate logos or registered marks of third-party enterprises.

Bundled Fictional Demo Brands Directory
Brand Name Slug Identifier Category / Focus Licensing & IP Status
Apex Active apex Athletic & High-Performance Sportswear Royalty-Free / Fictional
Velox Sport velox Performance Running & Cross-Training Shoes Royalty-Free / Fictional
SprintX sprintx Athletic Footwear & Aerodynamic Track Apparel Royalty-Free / Fictional
Aura Studio aura Contemporary Designer Fashion & Luxury Apparel Royalty-Free / Fictional
RawDenim Co. rawdenim Authentic Heritage Denim, Jeans & Casual Wear Royalty-Free / Fictional
Nordic Basics nordic Minimalist Everyday Basics & Organic Cotton Essentials Royalty-Free / Fictional
Stride Lab stride Modern Ergonomic Lifestyle & Casual Sneakers Royalty-Free / Fictional
Solstice Optics solstice Polarized Sunglasses, Frames & Luxury Eyewear Royalty-Free / Fictional
Chronos & Co. chronos Classic Horology, Heritage Leather & Chronographs Royalty-Free / Fictional
Zenith Time zenith Precision Tactical Chronometers & Rugged Digital Watches Royalty-Free / Fictional
Production Commercial Store Recommendation:

While all demo assets are legally safe for development and local staging, store operators are advised to upload their own authentic brand catalogs, photography, and manufacturer agreements via the Admin Dashboard → Catalog Management → Brands and Products Management prior to launching a live commercial retail store.

Non-Affiliation Notice: Any resemblance between fictional brand names or aesthetic motifs and existing trademarks is purely coincidental. MartX is completely unaffiliated with any third-party fashion or electronics conglomerate.

MartX Production Release Architecture

Official Stable Release: Verified out-of-the-box enterprise commerce capabilities

STABLE v1.0.0
v1.0.0 • LIVE Current Production Release
100% Launch Ready
  • 6 Core Payment Gateways: Stripe, PayPal, Razorpay, SSLCommerz, Paystack & COD
  • Anti-Tamper Security: Server-side price lock, idempotency checks & stock deadlock defense
  • Dynamic Geographic Shipping: Tiered distance rates, country restrictions & courier sync
  • Google Gemini AI Inquiry Desk: Real-time customer support & contextual responses
  • Self-Healing Stripe Webhooks: Auto-recovery polling on missed payment events
  • Enterprise Role-Based Access: Spatie RBAC with granular staff permission gates
Documentation
⚡ 3-Minute Quick Start 1. Introduction & Overview 2. Server Requirements 3. Installation Guide 4. License Activation 5. Dashboard Telemetry 6. Media Manager 7. Catalog Management 8. Products Management 9. Orders & Fulfillment 10. Couriers & Shipping Costs 11. Coupons & Marketing 12. Payment Gateways 13. Theme Layouts Hub 14. Navigation & Mega Menus 15. Sliders & Banners 16. Pages, FAQ & About 17. Blogs & Editorial 18. Reviews & Messages 19. Team Members & Staff Roles 20. Locations & Coverage 21. System Settings Hub 22. Web Cron & FAQs 23. Extra Security & Speed Boost