Admin Journey

This guide covers everything a Siyahfy platform administrator does on a day-to-day basis. Admins oversee vendors, review theme submissions, manage affiliates, process developer payouts, and monitor platform-wide analytics. All admin tasks are performed from the admin panel at app.siyahfy.com/admin.

Overview Flow

Step 1: Login to Admin Panel

Admins access the platform at app.siyahfy.com/admin using their admin credentials. Admin accounts are created by other admins or provisioned during platform setup — there is no public registration for admin roles.

What happens: The system authenticates the admin against the admin users table and issues a JWT token. The admin panel loads with the dashboard overview.

Related: Getting Started — Overview

Step 2: Dashboard Overview

The admin dashboard provides a high-level view of platform health:

• Total vendors and new signups over the selected period
• Total orders across all stores
• Platform revenue (subscription fees + marketplace commissions)
• Pending actions — theme submissions awaiting review, payout requests to process, vendors pending approval
• Recent activity feed

This is your command center. From here, you can jump into any management area.

Related: Analytics & Reports

Step 3: Manage Vendors

Vendor Approval

When new vendors sign up, you may need to review and approve their accounts (depending on platform settings). View pending vendor applications, review their details, and approve or reject them.

Vendor Suspension

If a vendor violates platform policies, you can suspend their account. Suspension options include:

Suspended vendors receive an email notification with the reason for suspension.

Vendor Details

For each vendor, you can view:

• Store details (name, domain, products, orders)
• Current subscription plan
• Revenue and order history
• Team members and their roles

What happens: Vendor status changes update the stores table. When a store is suspended, the storefront returns a “store unavailable” page. Reactivation restores the store to its previous state.

Related: Team Management

Step 4: Review Theme Submissions

This is one of the most important admin tasks. When developers submit themes through Siyahfy Studio, they appear in the Theme Submissions queue.

Review Workflow

For each pending submission, you see:

• Developer name and email
• Theme name, version number, and changelog
• Submission date

You have three tools for review:

1. Preview — See the theme rendered with sample store data, exactly as a vendor would see it
2. Browse Code — Read through the source files to check code quality, security, and guideline compliance
3. Take Action:

Quality Checklist

When reviewing a theme, check for:

• Valid Props interfaces on all sections
• No hardcoded content (everything should be configurable)
• Responsive design (works on desktop, tablet, and mobile)
• No external API calls or security concerns
• Clean, readable code
• Proper use of the JSDoc annotation system

What happens: Approval calls POST /api/marketplace/admin/versions/:id/approve, which changes the version status to “published” and makes it visible in marketplace listings. Rejection calls POST /api/marketplace/admin/versions/:id/reject with a reason string.

Related: Theme Marketplace | Developer Studio

Step 5: Manage Affiliates

Siyahfy supports affiliate programs where vendors can let external partners promote their products for a commission.

As an admin, you oversee:

• Affiliate registrations — review and approve new affiliate applications
• Commission tracking — monitor commissions earned across the platform
• Referral links — view which affiliates are driving traffic and sales
• Payouts — track affiliate commission payouts

Affiliate Moderation

If an affiliate uses prohibited promotional methods (spam, misleading ads, etc.), you can:

• Suspend their affiliate account
• Reverse fraudulent commissions
• Permanently ban them from the program

What happens: Affiliate actions update records in the affiliate-related tables. Commission calculations are based on the rules set by each vendor (percentage of sale, fixed amount per referral, etc.).

Related: Affiliate Program

Step 6: Process Developer Payouts

When theme developers request a payout (minimum INR 500), the request appears in the Developer Payouts section.

Payout Workflow

Each payout request shows:

• Developer name and contact info
• Amount requested
• Payment method (Bank transfer or UPI)
• Current status

You process payouts in three stages:

What happens: Status updates call the admin payout endpoints (/api/marketplace/admin/payouts/:id/process, /complete, or /fail). Each action updates the developer_payouts table and adjusts the developer’s available balance in developer_earnings.

Related: Developer Journey

Step 7: Platform Analytics

The platform analytics section gives you a bird’s-eye view of the entire Siyahfy ecosystem.

Key Metrics

Reports

You can generate reports filtered by:

• Date range (daily, weekly, monthly, custom)
• Vendor or store
• Product category
• Payment method

Reports can be used to identify growth trends, spot underperforming areas, and make data-driven decisions about platform features and pricing.

Related: Analytics & Reports

Step 8: Plan Management

Siyahfy offers different subscription plans to vendors. As an admin, you manage the plan catalog and assign plans to vendors.

Plan Operations

• Create plans — Define plan name, price, billing cycle (monthly/annual), and feature limits (max products, max staff, max stores)
• Edit plans — Update pricing or feature limits for existing plans
• Assign plans — Manually assign or change a vendor’s plan (useful for enterprise deals or promotional offers)
• Plan upgrades/downgrades — When a vendor changes their plan, the system prorates the charge automatically

Feature Limits by Plan

Plans control access to features:

What happens: Plan assignments update the vendor’s subscription record. Feature limits are enforced by the API — for example, if a vendor on the Starter plan tries to add a 51st product, the API returns an error.

Related: Getting Started — Overview

Step 9: Theme Moderation

Beyond the initial review process, admins can moderate published themes that receive complaints or violate guidelines after publication.

Moderation Actions

Featured themes appear in a prominent carousel on the marketplace, driving more visibility and installs for high-quality work.

What happens: Termination updates the theme’s visibility status. Existing installations continue to work (vendors who already installed the theme keep it), but new installations are blocked. Featuring a theme adds it to the GET /api/marketplace/featured endpoint results.

Related: Theme Marketplace