Our Goals & Vision

Our Mission

Generous Commerce Connectors automates how merchants onboard to Generous's AI-powered gifting marketplace. By building native plugins for Salesforce Commerce Cloud and Shopify, we eliminate manual product catalog exports, standardize data across platforms, and deliver a secure, scalable ingestion pipeline so Generous can grow from dozens of brands to thousands without increasing operational overhead.

Core Objectives

Convenient for Merchants

  • Native plugins inside existing admin tools (Business Manager & Shopify Admin)
  • Merchants select and export products without manual data reformatting
  • Scheduled and on-demand feed export jobs
  • Clear sync status and actionable error feedback

Low Maintenance for Generous

  • Versioned API-first design keeps connectors lightweight and upgradeable
  • Asynchronous job processing handles catalog uploads without blocking the platform
  • Universal Product Schema normalizes data from all platforms automatically
  • Modular architecture supports adding new connectors without changing the core pipeline

Customizable & Secure

  • OAuth 2.0 and Stytch M2M authentication for all data transfer
  • Merchants control exactly which products are sent to Generous
  • Generous-specific product attributes configurable per item
  • Strict merchant data isolation enforced at every API boundary

Key Features & Capabilities

Salesforce Commerce Cloud Cartridge

A native SFCC cartridge integrated directly into Salesforce Business Manager. Merchants can configure Generous-specific product attributes, enable or disable products for export, run on-demand or scheduled export jobs, and view sync results, all without leaving their existing environment.

  • Business Manager UI extensions for product controls
  • Scheduled & on-demand JSONL feed export
  • Developer and merchant-facing documentation

Shopify Admin App

A Shopify Admin app that allows merchants to select products from their catalog, configure Generous-specific attributes, export product feeds on demand, and automatically re-export when catalog inventory or listings are updated.

  • Product selection & attribute management in Shopify Admin
  • Automatic export on catalog updates
  • Schema validation before data is sent to Generous

Ingestion API & Job Processing

A versioned REST API accepts catalog feed uploads from both connectors, authenticates merchants via OAuth 2.0 and Stytch M2M, and dispatches feed processing to a Redis/BullMQ background job queue for scalable, non-blocking ingestion.

  • Presigned upload URLs for secure feed delivery
  • Asynchronous job processing with real-time status polling
  • Merchant ownership boundaries enforced throughout

Universal Product Schema

A shared validation and normalization engine converts platform-specific product data from SFCC and Shopify into Generous's Universal Product Schema before persisting to MongoDB, eliminating inconsistencies and enabling a single canonical data model.

  • Required field validation & business rule enforcement
  • Data normalization across all connected platforms
  • Item-level error reporting with per-row rejection details

Project Roadmap

Planning & Research

Q4 2025

Tech feasibility, requirements gathering, Engineering Fest poster, and SFCC plugin prototype

Sprint 1: Alpha Demo I

Feb 13, 2026

SFCC cartridge, Business Manager product controls, scheduled feed export, and Generous-compatible JSONL output

Sprint 2: Alpha Demo II

Mar 20, 2026

Shopify Admin app, ingestion API, OAuth authentication, Redis/BullMQ job queue, and schema validation

Sprint 3: Acceptance Demo

May 1, 2026

Full end-to-end integration, 169 passing tests, client usability validation, and final delivery to Generous

Future Work

With the core connector architecture in place, the platform is designed to extend to additional commerce platforms and capabilities.

Shopify App Store & Salesforce AppExchange

Publish both connectors to official platform marketplaces for broader merchant discovery and installation.

BigCommerce & Adobe Commerce

Extend the connector architecture to additional platforms without modifying the core ingestion pipeline.

Zapier Integration

Enable no-code workflow automation so any platform merchant can connect to Generous through Zapier triggers.