Tu primer widget de Livedeck: del starter kit a la subida

Descarga el starter kit, modifícalo, súbelo como ZIP y pruébalo en el editor.

6 min de lectura Actualizado el 4 nov 2026

El starter kit es un widget terminado llamado "Live Feed": muestra regalos, seguidores y chat como tarjetas y cuenta los Me gusta. Crea el tuyo a partir de ahí.

Qué incluye el paquete

manifest.json

Nombre, versión, tamaño, permisos y ajustes del widget

index.html

La página de inicio. Carga el SDK y tus archivos.

style.css

El aspecto

app.js

La lógica: reacciona a los eventos

README.md

Guía rápida

La página de inicio

Cada página de inicio carga el SDK desde la ruta /sdk/v1.js. Livedeck lo sirve en la dirección de tu widget; no tienes que meterlo tú en el paquete. Carga todos tus demás archivos con rutas relativas.

html
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <link rel="stylesheet" href="style.css">
  <!-- Livedeck serves the SDK. Everything else lives in your package. -->
  <script src="/sdk/v1.js"></script>
</head>
<body>
  <div id="feed"></div>
  <script src="app.js"></script>
</body>
</html>

Reaccionar a eventos

js
function show(text) {
  const line = document.createElement("p");
  line.textContent = text; // textContent, never innerHTML: names are viewer text
  document.getElementById("feed").prepend(line);
}

livedeck.on("gift", (e) => {
  // "@" + e.user.handle (username), e.gift.name, e.count, e.totalDiamonds
  show("@" + e.user.handle + " sent " + e.count + "× " + e.gift.name);
});

livedeck.on("follow", (e) => {
  show("@" + e.user.handle + " followed you");
});

livedeck.ready(() => {
  // The overlay is connected and the settings are here.
  document.body.style.color = livedeck.settings.accent;
});

Un widget solo recibe los eventos que pide en permissions dentro de manifest.json. En el ejemplo de arriba son events.gift y events.follow.

Comprimir y subir

  1. Sube la versión en manifest.json (por ejemplo, de 1.0.0 a 1.0.1) para poder distinguir tus versiones más adelante.
  2. Comprime los archivos en ZIP. manifest.json tiene que estar en el nivel superior del ZIP o dentro de la única carpeta que lo contiene todo. Windows: selecciona los archivos › clic derecho › Enviar a › Carpeta comprimida (en zip). Mac: selecciona los archivos › clic derecho › Comprimir.
  3. En el dashboard: Editor › Mis widgets › “Subir el tuyo”. La primera vez creas un perfil de desarrollador y aceptas las normas.
  4. En más o menos un minuto termina la revisión. ¿No la pasó? Verás cada motivo con archivo y línea, o con el valor medido. Corrígelo y sube un ZIP nuevo.
  5. Coloca el widget en el lienzo y pruébalo con los botones de prueba de sus ajustes (regalo, chat, Me gusta y más).
Consejo: Nombra tus archivos solo con letras de la a a la z, dígitos, guion y guion bajo. Livedeck ignora archivos del sistema como __MACOSX, .DS_Store o Thumbs.db.
Nota: Los eventos de prueba del editor y del Marketplace llegan con livedeck.context.test = true y espectadores inventados. En el enlace de OBS el valor es false.

¿Te resultó útil este artículo?