Seu primeiro widget do Livedeck: do starter kit ao upload

Baixe o starter kit, modifique, envie como ZIP e teste no editor.

6 min de leitura Atualizado em 4 de nov. de 2026

O starter kit é um widget pronto chamado “Live Feed”: ele mostra presentes, seguidores e chat em cards e conta as curtidas. Crie o seu a partir dele.

O que vem no pacote

manifest.json

Nome, versão, tamanho, permissões e configurações do widget

index.html

A página inicial. Ela carrega o SDK e seus arquivos.

style.css

O visual

app.js

A lógica: reage aos eventos

README.md

Guia rápido

A página inicial

Toda página inicial carrega o SDK pelo caminho /sdk/v1.js. O Livedeck o disponibiliza no endereço do seu widget; você não precisa colocá-lo no pacote. Carregue todos os outros arquivos com caminhos relativos.

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>

Reagindo 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;
});

Um widget só recebe os eventos que pede em permissions no manifest.json. No exemplo acima, são events.gift e events.follow.

Compactar e enviar

  1. Aumente a versão no manifest.json (por exemplo, de 1.0.0 para 1.0.1) para conseguir diferenciar suas versões depois.
  2. Compacte os arquivos em ZIP. O manifest.json precisa estar no nível principal do ZIP ou dentro da única pasta que contém tudo. Windows: selecione os arquivos › clique com o botão direito › Enviar para › Pasta compactada. Mac: selecione os arquivos › clique com o botão direito › Comprimir.
  3. No painel: Editor › Meus widgets › “Enviar o seu”. Na primeira vez, você cria um perfil de desenvolvedor e aceita as regras.
  4. Em cerca de um minuto a verificação termina. Não passou? Você vê cada motivo com arquivo e linha, ou com o valor medido. Corrija e envie um novo ZIP.
  5. Coloque o widget no canvas e teste com os botões de teste nas configurações dele (presente, chat, curtidas e mais).
Dica: Nomeie seus arquivos só com letras de a a z, números, hífen e underline. O Livedeck ignora arquivos de sistema como __MACOSX, .DS_Store ou Thumbs.db.
Observação: Eventos de teste do editor e do Marketplace chegam com livedeck.context.test = true e espectadores fictícios. No link do OBS, o valor é false.

Este artigo foi útil?