Vasty Shop

Open-source multi-vendor e-commerce marketplace

Enterprise-grade marketplace with AI recommendations, Stripe Connect payouts, flash sales, POS, delivery management, and 17-language support.

🌐 Try the Live Demo →

Live Demo | Quick Start | Features | Deployment | Discussions | Contributing

English | 日本語 | 中文 | 한국어 | Bahasa Indonesia | Bahasa Melayu | Español | Français | Deutsch | Italiano | Português | العربية | Türkçe | हिन्दी | বাংলা | اردو | Русский

Table of Contents

• What is Vasty Shop?
• Why Vasty Shop?
• Vendor Dashboard
• Quick Start
• Features
• Delivery Management
• Storefront Builder
• Tech Stack
• Project Structure
• Deployment
• Changelog
• Contributing
• Security
• License

What is Vasty Shop?

Vasty Shop is an open-source multi-vendor e-commerce marketplace platform. Build your own marketplace like Amazon, Shopify, or Etsy with AI-powered recommendations, Stripe Connect vendor payouts, flash sales, POS system, and delivery management — all self-hostable.

Why Vasty Shop? (Comparison)

Vendor Dashboard

Every vendor gets a self-service control panel with real-time KPIs (revenue, orders, products, customers), an earnings breakdown — gross sales, delivery costs, net profit — and full order, product, and approval management.

Quick Start

Docker (Recommended)

Prerequisites: Docker and Docker Compose

git clone https://github.com/vasty-shop/vasty-shop.git
cd vasty-shop

# 1. Create env files from examples
cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env

# 2. (Optional) Run the setup wizard to pick providers interactively
docker compose --profile setup run --rm setup

# 3. Start all services (PostgreSQL, Redis, Backend, Frontend)
docker compose up --build

# 4. Run database migrations (in a new terminal)
docker compose exec backend npm run migrate

# 5. (Optional) Seed the database
docker compose exec backend npm run seed

The app will be available at:

Default Admin Credentials

Note: Change the admin password immediately in production.

Docker Services

Useful Commands

# Stop all services
docker compose down

# Stop and remove all data (database, redis)
docker compose down -v

# View backend logs
docker compose logs -f backend

# Run migrations
docker compose exec backend npm run migrate

# Seed database
docker compose exec backend npm run seed

# Access PostgreSQL shell
docker compose exec postgres psql -U postgres -d vasty_shop_dev

# Run setup wizard (pick providers interactively)
docker compose --profile setup run --rm setup

# Start with optional services (e.g. Meilisearch, MinIO)
docker compose --profile meilisearch --profile minio up -d

Local Development (without Docker)

Prerequisites: Node.js 20+, PostgreSQL 16+, Redis 7+

git clone https://github.com/vasty-shop/vasty-shop.git
cd vasty-shop

# Backend
cd backend
cp .env.example .env
# Edit .env: set DATABASE_HOST=localhost and REDIS_HOST=localhost
npm install
npm run migrate
npm run start:dev

# Frontend (new terminal)
cd frontend
cp .env.example .env
npm install --legacy-peer-deps
npm run dev

Features

E-Commerce Core

Everything needed to run an online storefront — catalog, cart, checkout, and post-purchase.

• Products -- Variants, attributes, inventory, digital products, bulk import
• Orders -- Multi-vendor order splitting, status tracking, refunds
• Cart -- Persistent cart, guest checkout, multi-currency
• Categories -- Nested categories with filters and search
• Reviews -- Ratings, photos, verified purchase badges

Payments & Finance

Multi-provider payments with automatic platform fees, vendor payouts, and financial tracking.

• Stripe Connect -- Auto vendor payouts with platform fee
• PayPal -- Alternative payment gateway
• Wallet -- Customer wallet with top-up and spend
• Escrow -- Secure payment holding until delivery
• Disbursement -- Bulk vendor payouts, commission tracking
• Expenses -- Business expense tracking for vendors

Marketing & Growth

Demand-generation tools built-in — no third-party plugins required.

• Flash Sales -- Time-limited deals with countdown
• Campaigns -- Promotional campaigns with scheduling
• Coupons -- Percentage, fixed, free shipping
• Gift Cards -- Digital gift cards with balance
• Loyalty -- Points system with cashback
• Referral -- Customer referral program
• Surge Pricing -- Dynamic pricing based on demand

Operations

In-store and fulfillment workflows for vendors selling beyond the web.

• POS -- Point-of-sale with barcode scanning
• Delivery -- Zone-based pricing, tracking, delivery partners
• Parcel -- Parcel delivery management
• Tax -- Tax calculation by region
• Export -- CSV/Excel data export

Platform

Foundational capabilities that power every other module.

• 17 Languages -- AR, BN, DE, EN, ES, FR, HI, ID, IT, JA, KO, MS, PT, RU, TR, UR, ZH
• AI -- Product recommendations, smart search
• Blog/CMS -- Content management
• Chat -- Real-time customer-vendor messaging
• Notifications -- Email, WebSocket, push
• Admin Dashboard -- Full platform analytics

Delivery Management

Platform-wide delivery and shipping ops in one place: configure shipping methods and zones, register and manage delivery partners, track active shipments, and watch KPIs like average delivery time and in-transit count at a glance.

Storefront Builder

Vendors design their own storefront with a drag-and-drop page builder — hero banners, featured products, categories, testimonials, and custom pages — with a live preview pane that renders every change instantly side-by-side.

Tech Stack

Project Structure

vasty-shop/
├── backend/              # NestJS API (69 modules, 80+ tables)
│   ├── src/modules/      # products, orders, cart, payments, delivery,
│   │                     # campaigns, coupons, flash-sales, gift-cards,
│   │                     # loyalty, referral, pos, ai, blog, chat, ...
│   └── migrations/       # PostgreSQL migrations
├── frontend/             # React + Vite + Tailwind (17 languages)
├── shared/               # Shared types and utilities
└── .github/workflows/    # CI/CD

Deployment

Vasty Shop is built for self-hosting. Run it on any Docker-capable host — a VPS, Render/Railway/Fly, or your own Kubernetes cluster.

Common deployment paths:

• Single-host Docker — the included docker-compose.yml is production-capable with a few env tweaks (switch build targets, use managed volumes, put a reverse proxy in front).
• Managed Postgres + Redis — point DATABASE_URL / REDIS_HOST at a managed instance and run only the backend/frontend containers.
• Provider setup — storage, email, payments, search, SMS, and AI are all pluggable via environment variables. Full provider catalog and setup guides: backend/docs/providers/.

Pre-launch checklist:

• [ ] Change the default admin password ([email protected] / admin123)
• [ ] Set JWT_SECRET to a strong random value
• [ ] Set NODE_ENV=production on the backend
• [ ] Configure at least one email provider for transactional mail
• [ ] Configure a storage provider (S3/R2/MinIO) for uploaded media
• [ ] Rotate backend/.env secrets out of the repo and version control

Changelog

See CHANGELOG.md for version history and notable changes.

Contributors

Thank you to all the amazing people who have contributed to Vasty Shop! 🎉

Want to see your face here? Check out our Contributing Guide and start contributing today!

Project Activity

Security

Please report vulnerabilities responsibly. See SECURITY.md.

License

This project is licensed under the AGPL-3.0 License - see the LICENSE file for details.

This means you can freely use, modify, and distribute this software, but any modifications must also be open-sourced under the same license.

Copyright 2025 Vasty Shop Contributors.