Skip to Content

Siyahfy Platform Documentation

Welcome to the complete documentation for the Siyahfy multi-vendor e-commerce SaaS platform. This documentation covers everything — architecture, features, APIs, database, deployment, and more.

Platform at a Glance

MetricCount
Apps & Services9
API Endpoints584+
Database Tables30+
Features18+
Route Files108

Apps & Services

Vendor Dashboard

app.siyahfy.comlocalhost:3000

Admin & vendor dashboard for store management, products, orders, analytics, and team management.

Tech: Next.js 14, Shopify Polaris, Redux Toolkit

Backend API

backend.siyahfy.comlocalhost:3003

Central REST API server handling all business logic, payments, file processing, and integrations.

Tech: Express.js, PostgreSQL, Redis

Theme Editor

editor.siyahfy.comlocalhost:3002

Visual drag-and-drop theme editor for vendors to customize their storefront without coding.

Tech: Next.js 16, TipTap, dnd-kit

Developer Studio

studio.siyahfy.comlocalhost:3012

Full IDE for developers to create, test, and submit themes to the marketplace.

Tech: Next.js 16, Monaco Editor, Sandpack

Marketing Website

siyahfy.comlocalhost:3000

Public-facing marketing website with landing pages, pricing, and product information.

Tech: Next.js 14, Three.js, Framer Motion

Default Theme

siyahfy-theme-2502localhost:3001

Default storefront template that comes with every new store. Pre-built cart, checkout, and product pages.

Tech: Next.js 16, React 19

Storefront Proxy

backend-store.siyahfy.comlocalhost:5014

Reverse proxy and domain routing layer. Resolves store domains and routes requests to the correct theme server.

Tech: Express.js, http-proxy-middleware, PostgreSQL, Redis

Developer Portal

developer.siyahfy.comlocalhost:3000

Dashboard for app developers to manage published apps, track installs, analytics, and credit packs.

Tech: Next.js 16, React 19, Shadcn/ui, Zustand

App Store

store.siyahfy.comlocalhost:3000

App marketplace where store owners browse, search, and install apps for their online stores.

Tech: Next.js 16, React 19, Zustand, Tailwind CSS


Features Overview

📦

Product Management

Full product CRUD, variants, attributes, bulk upload, Shopify import, media management.

🛒

Order Processing

Order lifecycle, fulfillment, invoices, draft orders, abandoned checkout recovery.

👥

Customer Management

Customer profiles, segmentation, addresses, order history, communication.

🏷️

Discounts & Offers

Discount codes, percentage/fixed discounts, conditions, usage limits.

🚚

Shipping

Shipping zones, rate calculation, Delhivery integration, COD control.

💳

Payments

Razorpay and Cashfree integration, multiple payment methods, webhook handling.

📊

Analytics & Reports

Revenue, orders, product, and category-wise analytics with charts and exports.

🎨

Theme Marketplace

Developers create themes, admin reviews, vendors purchase. 80/20 revenue split.

✏️

Theme Editor

Visual drag-and-drop editor for vendors to customize sections, colors, fonts.

💻

Developer Studio

Full IDE with Monaco editor, live preview, theme submission, and earnings dashboard.

🤝

Affiliate Program

Referral system with OTP signup, commission tracking, and payout management.

📣

Marketing

Email campaigns, WhatsApp marketing, abandoned cart messaging, marketing analytics.

📝

Blog & Pages

Content management for static pages, blogs, shorts, and SEO.

📋

Inventory

Stock tracking, alerts, bulk stock updates, supplier management.

Bulk Operations

Bulk product upload/delete, Shopify import, bulk stock update, bulk collections.

👨‍💼

Team Management

Staff roles, permissions, vendor access control, role-based restrictions.

🔗

Integrations

Amazon Connect, Shopify Import, Delhivery Shipping, Firebase, Google Analytics.

🏪

Storefront

Customer-facing store with cart, checkout, wishlist, search, reviews, and ratings.