Ir al contenido

¿Qué es un artefacto?

Un artefacto es una web app que vive en su propia URL dentro de Undercromo. Lo escribes con HTML, CSS y JavaScript, y consume las variables globales del proyecto en vivo a través del runtime de la plataforma. Sirve para dashboards, controles, gráficas… sin servidor propio.

Un artefacto tiene tres fuentes:

FuentePara qué
HTMLLa estructura de la página.
CSSLos estilos.
JavaScriptLa lógica: leer, observar y escribir gVar.

Cada fuente admite hasta 200 000 caracteres, con un total combinado de hasta 600 000 caracteres. Es espacio de sobra para apps completas (puedes usar CDNs, HTML completo, etc.).

La plataforma inyecta el runtime automáticamente al servir tu artefacto. No agregas ningún <script>: cuando tu JavaScript corre, ya tienes disponible el objeto global:

window.Undercromo.gvar

Tu CSS y tu JS también se inyectan por ti; en tu HTML solo escribes el marcado (no necesitas enlazar tus propios archivos).

<!-- Tu HTML: solo el marcado -->
<h1>Temperatura</h1>
<p id="valor"></p>
// Tu JS: el runtime ya está disponible
Undercromo.gvar.observe("temperatura", (v) => {
document.querySelector("#valor").textContent = v;
}, { immediate: true });
  • Cada artefacto se sirve en su propia URL.
  • Puede ser público (cualquiera con el enlace) o privado (según el proyecto).
  • El editor ofrece una vista previa embebida mientras desarrollas.