Volver al resumen
Marketplace
Descubre, instala y publica packages reutilizables para tus sitios web.
¿Qué es el Marketplace?
El Marketplace es un ecosistema abierto donde agencias y desarrolladores publican, comparten y venden componentes reutilizables. Un package es un bloque listo para usar (hero, tabla de precios, pie de página, etc.) que añades a tu sitio con un clic.
Categorías:
• Layout – Diseños y estructuras de página
• Content – Bloques de contenido listos para usar
• Interaction – Elementos interactivos (formularios, sliders)
• Social Proof – Testimonios, reseñas, valoraciones
• Notification – Banners, popups, alertas
• Navigation – Menús, migas de pan, pies de página
• Global – Otros packages
Modelos de precio:
• Gratis – Instalación libre
• Único – Pago único, acceso permanente
• Suscripción – Pago mensual por actualizaciones y soporte
Roles: solo los administradores (Admin) pueden instalar y publicar packages.
Buscar e instalar packages
Paso a paso:
1. Ve a Marketplace en el menú principal
2. Usa la barra de búsqueda para buscar por nombre o palabra clave
3. Filtra por categoría (Layout, Content, etc.) o precio (gratis, único, suscripción)
4. Haz clic en un package para abrir la página de detalle
5. Revisa la descripción, capturas de pantalla, reseñas y precio
6. Haz clic en "Instalar" (gratis) o "Comprar e instalar" (de pago)
7. Elige el sitio donde quieres instalar el package
8. El package aparece inmediatamente en tu selector de bloques en el editor de páginas
Consejos
- Empieza con packages gratuitos para conocer el Marketplace.
- Lee las reseñas de otros usuarios antes de comprar un package de pago.
- Puedes ver los packages instalados en Marketplace → Mis instalaciones.
Comprar packages de pago
Para packages de pago el proceso es:
1. Haz clic en "Comprar e instalar" en la página de detalle
2. Serás redirigido a Stripe Checkout
3. Introduce tus datos de pago y confirma
4. Después del pago exitoso serás redirigido al CMS
5. El package se instala automáticamente en el sitio elegido
Estado de licencia:
• 🟢 Licencia activa – El package funciona completamente
• 🔴 Licencia expirada – Para suscripciones canceladas
Con un pago único tienes acceso permanente. Con una suscripción el package funciona mientras tu suscripción esté activa.
Nota
- Revisa las condiciones de precio antes de suscribirte.
- Al cancelar una suscripción el package permanece instalado pero muestra una insignia de 'licencia expirada'.
Publicar un package: Preparación
Para publicar un package necesitas:
• Un bundle JavaScript (.js) – Tu componente como módulo ESM (máx. 500KB)
• Opcional: un archivo CSS (.css) – Estilos adicionales para tu componente
• Imágenes de vista previa – Mínimo 1, máximo 5 capturas de pantalla
El bundle JS debe exportar un componente page builder válido. Usa tu bundler favorito (Vite, Rollup, esbuild) para empaquetar tu componente React como ESM.
Requisitos del manifiesto:
• Nombre: @scope/nombre-del-package (ej. @miagencia/hero-premium)
• Versión: formato semver (ej. 1.0.0)
• Nombre visible: nombre legible (ej. "Sección Hero Premium")
• Descripción: mínimo 10 caracteres
• Categoría: elegir entre Layout, Content, Interaction, etc.
• Sectores: para qué sectores es relevante (dentista, restaurante, etc.)
• Licencia: free o commercial
Consejos
- Mantén tu bundle lo más pequeño posible – máx. 500KB.
- Prueba tu componente localmente en el editor de páginas antes de publicar.
- Usa design tokens (--dt-*) para que tu componente se adapte al tema de cada sitio.
Publicar un package: Paso a paso
El asistente de publicación tiene 4 pasos:
Paso 1 – Subir bundle:
• Arrastra tu bundle .js al campo de carga (máx. 500KB)
• Opcional: añade un archivo .css
Paso 2 – Rellenar manifiesto:
• Nombre (@scope/nombre-del-package)
• Versión (1.0.0)
• Nombre visible y descripción
• Seleccionar categoría y sectores
• Compatibilidad de versión del editor
• Seleccionar dependencias de tokens
• Elegir licencia (free/commercial)
Paso 3 – Imágenes de vista previa:
• Sube 1-5 capturas de pantalla de tu componente
• Opcional: añade una URL de demostración
Paso 4 – Revisar y publicar:
• Revisa un resumen de todos los datos introducidos
• Haz clic en "Publicar" para enviar tu package
• Después de la revisión tu package será visible en el Marketplace
Consejos
- Buenas capturas de pantalla aumentan la probabilidad de que otros instalen tu package.
- Añade una URL de demostración para que los compradores potenciales vean tu componente en acción.
Establecer el precio de tu package
En el paso 2 del asistente de publicación estableces el precio:
Gratis:
• Selecciona "Gratis" como modelo de precio
• Cualquiera puede instalar tu package directamente
Único:
• Selecciona "Único" como modelo de precio
• Introduce el precio en euros (ej. 29 €)
• Los compradores pagan una vez a través de Stripe Checkout
• Se crea automáticamente un Stripe Product + Price
Suscripción:
• Selecciona "Suscripción" como modelo de precio
• Introduce el precio mensual en euros (ej. 9 €/mes)
• Los compradores pagan mensualmente a través de Stripe
• Al cancelar, el comprador pierde acceso a las actualizaciones
Puedes ver tus ingresos en Marketplace → Revenue Dashboard.
Consejos
- Los packages gratuitos obtienen más instalaciones y ayudan a construir tu reputación.
- Considera un precio único bajo para componentes premium.
- Las suscripciones funcionan bien para packs de componentes que actualizas regularmente.
Gestionar y actualizar packages
Después de la publicación puedes gestionar tus packages:
• Ver estadísticas de instalación y reseñas
• Publicar una nueva versión con un número de versión superior
• Ver tus ingresos en el Revenue Dashboard
Publicar una nueva versión:
1. Ve a Marketplace → Publicar
2. Sube el nuevo bundle
3. Aumenta el número de versión (semver: 1.0.0 → 1.1.0 para funcionalidades, 1.0.1 para correcciones)
4. Rellena los datos restantes
5. Publica
Los usuarios que ya instalaron tu package verán una notificación de actualización.
Consejos
- Usa versionado semántico: major.minor.patch (ej. 2.0.0 para cambios importantes).
- Responde a las reseñas para mejorar tu reputación.
Preguntas frecuentes (FAQ)
¿Qué tamaño puede tener mi bundle?
→ Máximo 500KB. Mantén tu bundle lo más pequeño posible para tiempos de carga rápidos.
¿Qué es semver?
→ Versionado semántico: major.minor.patch (ej. 1.2.3). Major = cambios importantes, minor = nuevas funcionalidades, patch = correcciones.
¿Qué licencias están disponibles?
→ 'free' (uso gratuito) y 'commercial' (de pago, licencia requerida).
¿Cómo recibo mis pagos de Stripe?
→ Los ingresos se procesan a través de Stripe. Puedes ver tus pagos en tu Stripe Dashboard.
¿Puedo desinstalar un package?
→ Sí, ve a Marketplace → Mis instalaciones y haz clic en "Desinstalar". El package se elimina de tu sitio.
¿Qué pasa si cancelo mi suscripción?
→ El package permanece instalado pero muestra una insignia de 'licencia expirada'. Ya no recibes actualizaciones.
¿Puedo eliminar mi package del Marketplace?
→ Contacta con soporte. Las instalaciones existentes siguen funcionando.
¿Qué sectores puedo seleccionar?
→ Dentista, Restaurante, Inmobiliaria, Abogado, Fitness, E-commerce, Fotografía, Freelancer, ONG, Startup, Educación, Salud y más.