Skip to main content

Overview

This documentation provides a comprehensive technical framework for the Soppiya Innovation Ltd SaaS e-commerce ecosystem. As an advanced platform for digital commerce, Soppiya is engineered to provide the performance of a custom-coded application with the scalability and ease of use characteristic of top-tier SaaS providers.

The Soppiya SaaS Ecosystem​

Soppiya is a cloud-native, multi-tenant e-commerce platform designed to handle the complexities of global retail at scale. Unlike traditional monolithic systems, Soppiya operates as a decoupled architecture where the administrative backend, data processing layer, and storefront presentation layer work in symphony to deliver a low-latency shopping experience.

Infrastructure & High Availability​

The Soppiya ecosystem is built upon a high-availability infrastructure that ensures 99.9% uptime.

  • Global Content Delivery Network (CDN): All theme assets (images, CSS, JS) are served via static.soppiya.com. This edge-computing approach minimizes "Time to First Byte" (TTFB) by serving files from the server closest to the end-user.
  • Auto-Scaling Resources: As a SaaS provider, Soppiya automatically manages server resources during traffic spikes (e.g., Flash Sales or Black Friday), ensuring consistent performance without manual intervention from the developer or merchant.

The Unified Data Layer​

At the heart of the ecosystem is a centralized database that synchronizes information across various modules:

  • Core Resources: Products, Collections, and Variants.
  • CMS Engine: Pages, Blogs, and Articles.
  • Logistic Engine: Integrated shipping profiles, real-time tax calculation via Country ISO codes, and multi-warehouse fulfillment logic.
  • Identity Management: A secure Customer/Account layer that manages authentication, order history, and regional marketing tags.

Multi-Market Logic​

One of Soppiya’s most advanced technical features is its native Market Object. This allows a single store instance to support multiple regional storefronts, each with its own:

  • Domain Mapping: Primary and secondary TLD or subdomain support.
  • Currency Conversion: Real-time BDT, USD, and other currency handling.
  • Language Localization: Automatic serving of JSON locale files based on the visitor’s market context.

Design Philosophy​

The architectural spirit of Soppiya is governed by three foundational principles: Modular Atomicity, Merchant Autonomy, and Developer Empowerment.

Modular Atomicity (Atomic Design)​

Soppiya rejects the concept of static page templates. Instead, it utilizes an Atomic Design Hierarchy:

  1. Blocks: The smallest units of UI (e.g., a "Price" block, a "Title" block).
  2. Sections: Reusable modules composed of blocks (e.g., a "Product Grid" or "Hero Slider").
  3. Section Groups: High-level JSON containers that allow merchants to stack multiple sections in the Header or Footer.
  4. Templates: The structural logic (JSON or Liquid) that organizes these components for specific routes (e.g., /products/ or /collections/).

This modularity ensures that code is DRY (Don't Repeat Yourself) and highly maintainable.

Merchant Autonomy​

Our philosophy is that Code is for Builders, Configuration is for Sellers. Soppiya bridges this gap through JSON Schemas. By defining a strict schema within a section or block, the developer creates a "Settings Interface" in the Soppiya Visual Editor. This empowers merchants to:

  • Modify typography and color schemes without touching CSS.
  • Reorder page layouts via drag-and-drop.
  • Connect settings to Dynamic Sources (Metafields), allowing for custom data points like "Care Instructions" or "Material Origin" to be updated via the admin dashboard.

Developer Empowerment: The "Global Access" Advantage​

Soppiya provides developers with a unique level of data flexibility that is often restricted in other platforms.

  • Global Data Accessors: Developers are not limited to the local context of a page. Using Soppiya’s unique Liquid syntax, you can fetch any resource from any file (e.g., _product['handle'] or _collection['all-products']). This eliminates the need for complex workarounds when building cross-functional UI elements like "Frequently Bought Together" or "Global Search."
  • Programmable Interactivity (AJAX API): Soppiya provides a native, asynchronous JavaScript API. This allows developers to build high-end features—such as real-time predictive search, slide-out "Mini-Carts," and instant checkout creation—without the overhead of third-party libraries or page refreshes.
  • Standardized Templating: By leveraging Liquid, Soppiya offers a syntax that is human-readable and logically robust, making it easy for developers to transition from other platforms while gaining Soppiya-specific power features.