Vendlay - Self-Hosted E-Commerce Platform

Own your store. Own your data.

A complete, production-tested e-commerce platform that runs on your own server with a single Docker command. All data lives in PostgreSQL - no third-party database services, no vendor lock-in. White-label by design: store name, logo, currency, colors and language are configured from the admin panel, no rebuild needed.

STOREFRONT (customers)

• Product catalog with categories, search, filters and featured products
• Product pages with image galleries, variants (color/size), reviews
• Cart, checkout and order tracking; customer accounts
• Pay by card (Stripe), PayPal, or mobile money (M-Pesa / e-Mola / M-Kesh via Paysgator) - plus WhatsApp checkout for social commerce
• English and Portuguese included; add languages via a single translations file
• Any currency (USD, EUR, GBP, BRL, ZAR, NGN, KES, MZN and more)

ADMIN PANEL (you)

• Dashboard with sales, orders and stock indicators
• Products, orders, customers and multi-store management
• Referral/partner program: codes, commission cycles, payouts, notifications
• Reports: payment funnel, reconciliation, logistics SLA, network overview, demand forecast
• Notifications: SMS (Twilio), WhatsApp Business, email (SMTP/Resend)
• Role-based access (admin, store admin, logistics, finance, network manager)
• Audit log and one-click JSON backup

TECH & DEPLOYMENT

• React 19 + Vite + Tailwind (storefront + admin in one SPA)
• Node.js payments/messaging service; Flask + SQLAlchemy data API
• PostgreSQL 16; Docker Compose; Caddy with automatic HTTPS (Let's Encrypt)
• Firebase used only for authentication (free tier is enough)
• Installation guide included - typical setup under 30 minutes

Licensing: full source code, no obfuscation. All third-party open-source libraries used are documented with their licenses in docs/THIRD_PARTY_NOTICES.md inside the package (all permissive: MIT/BSD/Apache-2.0, no GPL/AGPL).

Features

• Full storefront: catalog, search, filters, product variants, reviews, cart, checkout, order tracking
• Admin panel: dashboard, products/orders/customers, multi-store management
• Referral/partner program with commission cycles and payouts
• Stripe, PayPal and mobile money (M-Pesa/e-Mola/M-Kesh) payments
• WhatsApp checkout for social commerce
• SMS, WhatsApp Business and email notifications
• Role-based access control (admin, store admin, logistics, finance, network manager)
• Audit log and one-click JSON backup
• English and Portuguese included, easy to add more languages
• Any currency supported
• White-label: no rebuild needed to rebrand

Requirements

• A VPS with Docker installed (2 GB RAM minimum) and a domain name
• A free Firebase project (used only for authentication)
• A Stripe and/or PayPal account for payments (optional: Paysgator account for mobile money in Mozambique)

Instructions

1. Clone/extract the source code on your server
2. Copy the .env.example files and fill in your database, Firebase and payment gateway credentials
3. Run docker compose up -d --build
4. Run the included seed script to create demo data (optional)
5. Log in to the admin panel and configure your store name, currency, logo and languages

Full step-by-step instructions, including the third-party license notices, are included in the docs folder (INSTALLATION.md, THIRD_PARTY_NOTICES.md).