Theme Marketplace

Overview

The Theme Marketplace is Siyahfy’s built-in storefront for themes. Developers create themes using Siyahfy Studio, submit them for review, and once approved, themes become available for all Siyahfy vendors to browse, preview, and install. The marketplace supports both free and paid themes, with an 80/20 revenue split (80% to the developer, 20% to Siyahfy). Vendors can install, activate, update, and uninstall themes directly from their admin panel.

How It Works

Marketplace Lifecycle

Theme creation — Developers build themes in Siyahfy Studio (IDE) with sections, widgets, and configuration.
Submission — Developer submits a version for review with changelog notes.
Admin review — Platform admin inspects the theme version, can approve or reject with feedback.
Publication — Approved themes appear in the public marketplace.
Discovery — Vendors browse by category, search, or view featured themes.
Installation — Free themes install instantly; paid themes require Razorpay payment first.
Activation — Vendor activates the installed theme to make it live.
Updates — When developers publish new versions, vendors see update notifications.

Revenue Model

Party	Share
Developer	80% of theme sale price
Siyahfy	20% platform commission

Developers can track earnings and request payouts through the Studio dashboard.

Key API Endpoints

Public Marketplace

GET/api/marketplace/themes

List all published themes with pagination, search, and category filters

GET/api/marketplace/themes/:theme_slug

Get full details of a theme (description, screenshots, reviews, pricing)

GET/api/marketplace/themes/:theme_slug/reviews

Get reviews and ratings for a theme

GET/api/marketplace/featured

Get featured themes for the marketplace homepage

GET/api/marketplace/categories

Get all theme categories

GET/api/marketplace/preview/:preview_id

Get a live preview configuration for a theme

Vendor Theme Management

GET/api/marketplace/store-theme-info/:store_slugAuth Required

Get current theme info for a vendor's store

POST/api/marketplace/themes/:theme_slug/installAuth Required

Install a theme (free) or after payment (paid)

POST/api/marketplace/themes/:theme_slug/activateAuth Required

Activate an installed theme as the live store theme

DELETE/api/marketplace/themes/:theme_slug/uninstallAuth Required

Uninstall a theme from the store

GET/api/marketplace/my-themesAuth Required

Get all themes installed by the vendor

GET/api/marketplace/my-themes/updatesAuth Required

Check for available theme updates

POST/api/marketplace/themes/:theme_slug/updateAuth Required

Update an installed theme to the latest version

Theme Purchases

POST/api/marketplace/themes/:theme_slug/create-orderAuth Required

Create a Razorpay order for purchasing a paid theme

POST/api/marketplace/themes/:theme_slug/verify-paymentAuth Required

Verify Razorpay payment and complete theme purchase

GET/api/marketplace/themes/:theme_slug/purchase-statusAuth Required

Check if vendor has purchased a specific theme

Theme Reviews

POST/api/marketplace/themes/:theme_slug/reviewsAuth Required

Submit a review and rating for an installed theme

DELETE/api/marketplace/themes/:theme_slug/reviewsAuth Required

Delete a vendor's review on a theme

Developer Theme Management

POST/api/marketplace/developer/themesAuth Required

Create a new theme listing

PUT/api/marketplace/developer/themes/:theme_slugAuth Required

Update theme metadata (name, description, price, category)

GET/api/marketplace/developer/my-themesAuth Required

List all themes created by the developer

GET/api/marketplace/developer/themes/:theme_slugAuth Required

Get developer's view of a specific theme with version history

DELETE/api/marketplace/developer/themes/:theme_slugAuth Required

Delete a theme (only if unpublished)

POST/api/marketplace/developer/themes/:theme_slug/versionsAuth Required

Submit a new theme version for review

POST/api/marketplace/developer/themes/:theme_slug/save-draftAuth Required

Save theme code as a draft (not submitted for review)

GET/api/marketplace/developer/themes/:theme_slug/export/:version_idAuth Required

Export a theme version as a downloadable package

POST/api/marketplace/developer/themes/:theme_slug/importAuth Required

Import theme code from a package file

Developer Previews & Config

POST/api/marketplace/developer/export-store-configAuth Required

Export a store's theme configuration for preview purposes

POST/api/marketplace/developer/preview-configAuth Required

Create a preview configuration for a theme

PUT/api/marketplace/developer/preview-config/:idAuth Required

Update a preview configuration

Developer Earnings & Payouts

GET/api/marketplace/developer/earningsAuth Required

Get developer's earnings summary and breakdown by theme

POST/api/marketplace/developer/request-payoutAuth Required

Request a payout for accumulated earnings

GET/api/marketplace/developer/bank-detailsAuth Required

Get developer's saved bank account details

POST/api/marketplace/developer/bank-detailsAuth Required

Save or update bank account details for payouts

Admin Review & Management

GET/api/marketplace/admin/pending-reviewsAuth Required

List themes with versions pending admin review

GET/api/marketplace/admin/terminated-themesAuth Required

List terminated/suspended themes

GET/api/marketplace/admin/themes/:theme_slug/versions/:version_idAuth Required

Get a specific version's details for review

POST/api/marketplace/admin/themes/:theme_slug/versions/:version_id/approveAuth Required

Approve a theme version and publish it

POST/api/marketplace/admin/themes/:theme_slug/versions/:version_id/rejectAuth Required

Reject a theme version with feedback

POST/api/marketplace/admin/themes/:theme_slug/terminateAuth Required

Terminate a theme (remove from marketplace)

POST/api/marketplace/admin/themes/:theme_slug/restoreAuth Required

Restore a previously terminated theme

Admin Payout Management

GET/api/marketplace/admin/payoutsAuth Required

List all payout requests from developers

POST/api/marketplace/admin/payouts/:payout_id/processAuth Required

Mark a payout request as processing

POST/api/marketplace/admin/payouts/:payout_id/completeAuth Required

Mark a payout as completed

POST/api/marketplace/admin/payouts/:payout_id/failAuth Required

Mark a payout as failed

POST/api/marketplace/admin/verify-bank/:developer_idAuth Required

Verify a developer's bank details

GET/api/marketplace/admin/bank-verificationsAuth Required

List pending bank verification requests

Database Tables

Table	Purpose
`marketplace_themes`	Theme listings — name, slug, description, category, price, developer_id, status
`marketplace_theme_versions`	Version history per theme — code, changelog, review status, approved_at
`marketplace_installs`	Records of which vendor installed which theme
`marketplace_purchases`	Purchase records for paid themes (payment ID, amount, status)
`marketplace_reviews`	Theme reviews and ratings from vendors
`developer_bank_details`	Developer bank account info for payouts
`developer_payouts`	Payout requests and their processing status
`theme_editor_configs`	Active theme configuration per store

Theme Editor — Customize an installed theme visually
Developer Studio — Build themes for the marketplace
Storefront — The installed theme renders the customer-facing store