Saltar al contenido

Documentación

Apariencia

Cambia el color, la posición, el texto y el estilo del widget desde el dashboard o desde el código.

Puedes ajustar la apariencia del widget de dos formas. Usa la que más te acomode, o ambas.

Desde el dashboard (sin desplegar)

En Proyectos e instalación → Apariencia del widget tienes una vista previa del widget real. Lo que guardes ahí llega a tus usuarios sin volver a desplegar: el SDK lo descarga al cargar (GET /v1/widget-config) y lo guarda 5 minutos por pestaña.

Puedes elegir:

  • Color con un preset o un hex propio, y su variante para modo oscuro.
  • Modo: automático (según el sistema), claro u oscuro.
  • Bordes: rectos, normales o redondeados.
  • Fuente: la del sistema o la de tu página.
  • Botón flotante: visible u oculto, y su texto.
  • Posición: cualquiera de las cuatro esquinas.
  • Idioma: automático, español o inglés.

Presets de color

PresetClaroOscuro
Violeta (por defecto)#6d5dfc#8b7dff
Azul#2563eb#4f8bff
Verde#059669#10b981
Naranja#ea580c#fb7a3c
Rosa#db2777#f0529c
Grafito#18181b#f4f4f5

Desde el código

Las opciones de init() siempre ganan sobre el dashboard. Úsalas si quieres fijar la apariencia en el repositorio.

TypeScript
wutbug.init({
  projectKey: 'pk_tu_key',
  endpoint: 'https://api.wutbug.dev',
  position: 'bottom-left',
  launcherLabel: '¿Algo no funciona?',
  locale: 'es',
  theme: {
    accent: '#ea580c',
    accentDark: '#fb7a3c',
    mode: 'auto',
    radius: 'round',
    font: 'inherit',
  },
});

Si defines theme.accent en código sin accentDark, se usa el mismo color en ambos modos (no se hereda la variante oscura del dashboard). Para ignorar por completo la configuración del dashboard, usa remoteConfig: false.

Con la etiqueta script tienes data-accent, data-position, data-locale, data-launcher y data-launcher-label.

Tu propio botón

Oculta el botón flotante y abre el formulario desde tu interfaz:

HTML
<script type="module" src="https://cdn.wutbug.dev/v0/wutbug.js"
  data-project-key="pk_tu_key" data-endpoint="https://api.wutbug.dev" data-launcher="false"></script>

<button data-wutbug-open>Reportar un problema</button>

O con JavaScript: wutbug.open(). Ver API de JavaScript.

Aislamiento de estilos

El widget vive en un Shadow DOM: tus estilos no lo afectan y los suyos no afectan tu página. Con font: 'inherit' toma la fuente de tu página.