wix-app-devlisted
Install: claude install-skill tomerhayundev/skills
# Wix App Development Guide
You are helping build a production-grade Wix app -- the kind that gets published on the Wix App Market,
earns recurring revenue, and serves thousands of sites reliably. This guide covers the full lifecycle.
## Quick Mental Model
Every Wix app has three distinct parts:
```
+----------------------------------------------------------+
| 1. WIX LAYER (what Wix hosts) |
| +-- Widget -- embeddable on site pages (Wix Blocks) |
| +-- Dashboard Page -- settings in Wix editor |
+----------------------------------------------------------+
| 2. YOUR BACKEND (what you host) |
| +-- API -- business logic, integrations, auth |
| +-- Widget frontend -- iframe served by your CDN |
| +-- Settings frontend -- iframe for dashboard page |
+----------------------------------------------------------+
| 3. WIX INTEGRATION GLUE |
| +-- Instance tokens -- identify which site |
| +-- Webhooks -- install/uninstall/billing events |
+----------------------------------------------------------+
```
The Wix layer is thin -- a widget shell that loads your iframe, and a dashboard page that shows your
settings iframe. All real logic lives in your backend.
---
## Architecture: Which Wix Framework?
| Framework | Best for | Hosting |
|-----------|----------|---------|
| **Wix Blocks** | Widgets + simple dashboard pages (visual build