cavioca

Compartir y embeber

3 min

Compartir y embeber

Una vez publicada, tu app tiene una URL pública estable que puedes compartir en cualquier sitio: redes, chat, correo, blog. Esta página cubre cómo funcionan esos enlaces y cómo se ven cuando alguien los abre.

La URL pública

El formato es siempre:

https://cavioca.com/a/<slug>

Donde <slug> es el identificador que elegiste al publicar (ver marketplace). El slug es inmutable: una vez compartido, ese enlace funcionará mientras la app exista y esté publicada.

  • Si la app está despublicada, la URL devuelve 404.
  • Si despublicas y vuelves a publicar manteniendo el slug, la URL vuelve a funcionar y sirve la última versión.

Cómo se ve cuando se comparte

Cuando alguien pega tu enlace en WhatsApp, X, LinkedIn, Slack o similar, el otro lado ve una previsualización con:

  • El título de tu app.
  • La descripción que pusiste al publicar.
  • Una imagen Open Graph (OG) generada automáticamente por cavioca a partir del título y la categoría — no hace falta que subas nada.

stub La generación de imágenes OG personalizadas (subir tu propia imagen, controlar tipografía, fondos) está prevista pero todavía no expuesta. Hoy la imagen es una plantilla común para todas las apps.

Versiones específicas en el enlace

Por defecto, /a/<slug> sirve siempre la última versión publicada. Si necesitas enlazar a una versión concreta (por ejemplo, para fijar un demo en un blog post), puedes usar:

https://cavioca.com/a/<slug>/<version>

Donde <version> es el número de versión inmutable. Ver versiones y rollback para entender cómo se asigna ese número.

Embeber en otra web

stub El embebido como widget (un <iframe> o <script> reutilizable que cargue tu app en otra página) está en estudio pero no hay endpoint estable todavía. Mientras tanto, un <iframe> apuntando a /a/<slug> funciona para casos sencillos:

<iframe
  src="https://cavioca.com/a/mi-app"
  width="100%"
  height="600"
  style="border:0"
  loading="lazy"
></iframe>

Las cabeceras actuales no bloquean el iframe en dominios externos. Cuando llegue el embed oficial, dará opciones para controlar tamaño, tema y permisos sin tener que escribir HTML.

Compartir mientras editas

open Compartir un borrador (una URL privada solo para gente con el enlace, sin publicar al marketplace) está en la lista de peticiones pero no existe todavía. Hoy, para que alguien vea tu app, tienes que publicarla.

Si necesitas enseñar trabajo en curso sin que aparezca en /marketplace, el patrón provisional es: publicar con un slug poco descubrible, compartir el enlace directamente, y despublicar cuando hayas recibido feedback.

Analítica de visitas

deferred Un panel de estadísticas por app (visitas, referrers, países) está en el roadmap para más adelante. Hoy no hay contadores expuestos en el panel de la app.