Pexis Commerce – React TypeScript Supabase

Pexis Commerce is a production-oriented ecommerce source-code platform built with React, TypeScript, Vite and Supabase/PostgreSQL. It goes beyond a visual storefront template by including database migrations, Row Level Security, customer accounts, catalog and inventory foundations, order integrity controls, payment infrastructure, administrative tools, seller foundations and an optional AI-assisted commerce layer.

The package is designed for developers, freelancers, agencies and startups that want a serious ecommerce foundation they can customize instead of starting from an empty repository.

OPTIONAL AI-ASSISTED COMMERCE The commerce core works without an AI provider. Optional modules include intelligent search, shopping assistant, product questions/comparison, smart kits, smart wholesale support, recommendations, inventory analysis, admin copilot, content generation and embeddings/search foundations. AI and payment credentials remain server-side and are never expected in browser-exposed VITE_* variables.

SECURITY AND RELIABILITY The package emphasizes real commerce invariants rather than only UI components: PostgreSQL/RLS authorization foundations, least-privilege patterns, server-side secrets, stock reservation lifecycle, payment/webhook idempotency foundations, auditability, database migration validation helpers and security-oriented Edge Functions.

TECH STACK React 18, TypeScript, Vite 7, Supabase JS, PostgreSQL/Supabase, Supabase Edge Functions (Deno), i18next, Vitest, Playwright, pdfmake, Three.js (isolated/lazy-loaded visual lab).

INCLUDED IN THE DOWNLOAD Complete frontend source code, Supabase/PostgreSQL SQL migrations, Supabase Edge Functions, admin and seller foundations, tests and validation utilities, .env.example, English installation/configuration documentation, license and third-party notices, changelog.

CUSTOMIZATION The included storefront uses demo branding/content. Replace the demo identity, product media, favicon, contact details and legal text before production use. Deployment and white-label steps are documented in the package.

SUPPORT Support covers defects in the distributed package and reasonable clarification of the documented installation process. Custom development, custom design, provider account approval and server administration are not included.

Features

Modern responsive React storefront TypeScript + Vite architecture Supabase/PostgreSQL backend Supabase Auth and Row Level Security Categories, products, variants and attributes Catalog facets and server-side pagination foundations Product media/upload foundations Cart, favorites and customer account flows B2B/wholesale experience and price-tier foundations Order reservations and inventory integrity controls Idempotent order/checkout foundations Coupon integrity controls Mercado Pago-oriented payment flow Payment events, webhooks, refunds and reconciliation foundations Admin catalog/operations tooling Audit history foundations Seller acquisition and seller-panel foundations Five-language internationalization foundation SEO metadata and structured product data foundations Consent-aware analytics foundations Unit, SQL and Playwright E2E test suites

Requirements

Node.js ^20.19.0 or >=22.12.0 npm Supabase project Optional: Supabase CLI for Edge Functions Optional: Mercado Pago account for online payments Optional: supported AI provider API credentials

Instructions

1. npm install, depois cp .env.example .env, depois npm run dev 2. Crie um projeto no Supabase e preencha VITE_SUPABASE_URL e VITE_SUPABASE_ANON_KEY no .env 3. Rode as migrations SQL em supabase/ em ordem numérica pelo SQL Editor do Supabase 4. Configure Site URL e redirect URLs no Supabase Auth; crie o primeiro admin 5. Configure os secrets de backend (service role, pagamento, IA) direto no Supabase — nunca em variáveis VITE_* 6. npm run build && npm run preview para produção Guia completo de instalação e configuração incluído no pacote (pasta docs/).