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
| Metric | Count |
|---|---|
| Apps & Services | 9 |
| API Endpoints | 584+ |
| Database Tables | 30+ |
| Features | 18+ |
| Route Files | 108 |
Apps & Services
Vendor Dashboard
app.siyahfy.comlocalhost:3000Admin & vendor dashboard for store management, products, orders, analytics, and team management.
Tech: Next.js 14, Shopify Polaris, Redux Toolkit
Backend API
backend.siyahfy.comlocalhost:3003Central REST API server handling all business logic, payments, file processing, and integrations.
Tech: Express.js, PostgreSQL, Redis
Theme Editor
editor.siyahfy.comlocalhost:3002Visual 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:3012Full IDE for developers to create, test, and submit themes to the marketplace.
Tech: Next.js 16, Monaco Editor, Sandpack
Marketing Website
siyahfy.comlocalhost:3000Public-facing marketing website with landing pages, pricing, and product information.
Tech: Next.js 14, Three.js, Framer Motion
Default Theme
siyahfy-theme-2502localhost:3001Default 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:5014Reverse 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:3000Dashboard 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:3000App 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.
Quick Links
- Getting Started — Understand the platform and set up locally
- API Reference — Complete endpoint documentation
- Database Schema — All tables and relationships
- User Flows — Step-by-step journeys for each role
- Deployment Guide — Deploy to production