Foundation
Core platform capabilities for unified multi-marketplace operations.
Overview
The Foundation layer establishes the operational backbone of NexusCommerce. Every feature here is about getting your multi-marketplace operation under one roof: a single catalog, a unified order queue, consolidated inventory, and centralized marketplace connections.
These features are live from day one and require no AI worker configuration. They operate purely on the NestJS API and Supabase data layer.
Key Concepts
Unified Data Model — NexusCommerce maintains a single record per product SKU in the products table. Marketplace-specific listings are stored in marketplace_listings and linked to the parent SKU. This separation means you update a title once and push it to all connected marketplaces.
Sync Architecture — Each marketplace connection runs an adapter on a configurable polling interval. Adapters read from the marketplace API, transform the response into NexusCommerce's internal schema, and upsert records into Supabase. Webhooks (where supported) complement polling for sub-minute order latency.
Multi-tenancy — Every table in the database has a tenant_id column. Row Level Security (RLS) policies enforce that queries only return data belonging to the requesting tenant. The tenant_id is derived from the Supabase JWT on every API request.
Getting Started
Before using Foundation features, complete:
- Connect at least one marketplace
- Trigger an initial catalog sync from the Connections page
- Verify products appear in the Products catalog
Features
Dashboard
The main command center. See real-time stats across all connected marketplaces:
- Total revenue (today, 7d, 30d)
- Order count with fulfillment breakdown
- Return rate
- Inventory value
Active alerts surface problems that require action. The onboarding progress card guides new users through setup.
Products
Unified product catalog. Browse, search, and edit all SKUs. See per-marketplace listing status, pricing, and stock levels on a single product detail page.
Bulk operations: update prices, titles, or status across multiple SKUs at once using the CSV import/export.
Orders
All orders from all connected marketplaces in one queue. Filter by status, marketplace, date range, or fulfillment method. Click into any order to see line items, shipping details, and sync history.
Returns
Centralized returns processing. Each return is classified by reason (defective, wrong item, changed mind, etc.) and linked to the originating order. Return acceptance and refund actions are dispatched back to the originating marketplace.
Inventory
Multi-warehouse inventory management. View stock levels across warehouses, adjust quantities, and configure safety stock rules. Inventory changes sync to all connected marketplaces.
Connections
Manage marketplace integrations. Add, test, sync, and remove connections. View per-connection sync history and error logs.
Configuration
Foundation settings are under Settings > General and Settings > Connections.
| Setting | Default | Description |
|---|---|---|
| Default sync interval | 1 hour | Applied to new connections |
| Order lookback | 30 days | Historical orders to import on first sync |
| Inventory buffer | 10% | Safety stock percentage |
| Auto-sync on connect | Enabled | Triggers sync immediately after connection setup |