Developer Programme

Build themes.
Earn every time
a merchant installs.

Join a growing community of React developers building premium storefronts for artisan businesses. Upload your theme to the Spots marketplace and earn 80% of every licence sale — indefinitely.

80% revenue share
Full API documentation
CLI deploy tools
Dedicated payout wallet
500+Merchants on platform
40+Themes in marketplace
80%Developer revenue share
React+ Vite build stack

How it works

From first commit
to first sale.

1

Register your developer account

Sign up at /developer/register. Your dashboard gives you instant access to earnings, payout history, theme statuses, and review queue updates.

2

Generate your API key and build locally

Generate a secure X-Developer-Key from your dashboard. Authenticate your local Vite project and build against our fully documented storefront endpoints — products, cart, checkout, custom orders, and more.

3

Define your theme metadata

Create a spots-theme.json file declaring your theme's name, supported business types (bakery, chocolatier, café, restaurant), and compatible platform modules. Our compatibility engine uses this to match your theme to the right merchants.

4

ZIP and upload for review

Build your Vite project, zip the output, and upload it to the developer portal. Our extraction service handles asset URL rewriting automatically. You'll receive a review decision within 5 business days.

5

Earn on every install — indefinitely

Once approved, your theme is live in the marketplace. Every time a merchant installs it, you earn 80% of the sale price, credited instantly to your payout wallet. Withdraw to your bank account on your schedule.

Revenue model

Build once.
Earn every install.

When a merchant installs your theme, you earn 80% of the listed price. Spots keeps 20% as a platform fee. There are no listing fees, no monthly developer subscriptions, and no hidden deductions.

Earnings are credited to your payout wallet in real time. You can withdraw to your bank account at any time — there is no minimum threshold or hold period.

A single theme priced at ₦5,000 that attracts 50 installs earns you ₦200,000. Scale that across multiple themes and business types, and it becomes meaningful passive income.

Example earnings — 1 theme, ₦5,000 price
₦200,000
From 50 merchant installs at 80% share
Theme price₦5,000
Platform fee (20%)₦1,000
Your share per install₦4,000
Installs (example)50
Your total earnings₦200,000

What you build with

A modern stack.
Full API access.

React + Vite

Build your theme as a standard React SPA using Vite. No proprietary templating language — write real, modern JavaScript that you already know.

React 18+Vite 5ESM

Storefront API

Every piece of storefront data — products, variants, inventory levels, cart, orders, and custom request workflows — is accessible via documented REST endpoints.

RESTJSONAuth header

SDK & CLI

Install the Spots CLI to authenticate, preview your theme against a live test store, and deploy in a single command. No manual ZIP uploads during development.

npm install -g spots-cli

WebSocket Events

Subscribe to real-time order events, custom request updates, and cart reservation signals via the Spots WebSocket bus — perfect for live order trackers.

WebSocketsEvent bus

Delivery & Maps

The delivery fee API returns pre-calculated distance-based charges per address. Your theme just renders the total — no Google Maps key required on the frontend.

Delivery APIHaversine fallback

Theme Metadata Spec

A single spots-theme.json file declares your business type support, required modules, and entry point. Our compatibility engine handles the rest.

JSON configModule flags

Ready to build for
500+ artisan merchants?

Create your developer account, generate your API key, and ship your first theme. The marketplace is growing — and early developers get the most installs.