Skip to main content
Un artifact es un documento con format: "artifact": en vez de un Word o un PDF, Doconda entrega una página web que guarda datos. Lo que guarda se mantiene entre visitas. Se crea, se lista, se sigue y se cobra como cualquier documento. Es privado de tu proyecto: tú decides a quién le das el enlace (por ejemplo, dentro de tu producto, en un iframe).

Crear uno

Con una frase, y Doconda escribe la página:
O con tu contenido en Markdown, y Doconda lo convierte en la página (respetando tu texto):
Cuesta como cualquier documento creado, según su nivel de calidad. Cómo se hace: primero un plan de diseño corto (para qué sirve, secciones, colores y fuentes, interacción) que comprueba lo que la página puede hacer: guardar en doconda.db y usar Tailwind, Chart.js, d3 o dayjs, nada más (sin APIs externas, correo, pagos ni inicio de sesión; si lo pides, propone cómo resolverlo dentro de la página). Luego escribe un único HTML con todo dentro (también las imágenes), lo mira en ordenador y en móvil y corrige lo que se ve mal: una vez en fast y standard, dos en best. El evento artifact.planned trae el plan. Funcionan los tres modos: directo, stream y background. El estilo, en tus palabras, describe el aspecto de la página. Un artifact no lleva sources.

Dónde guarda sus datos

Eliges uno de dos modos con artifact.storage:
La página es la misma en los dos modos: usa doconda.db y Doconda decide dónde guardar.

El enlace

Cuando está listo, outputs trae un html cuyo url es la página. Ese enlace caduca en 1 hora; pide otro con la duración que necesites (hasta 7 días):
Cada artifact se sirve en su propio subdominio, aislado de tu web, de Doconda y de los demás artifacts (allow-same-origin se refiere a ese subdominio, que es el suyo).
Quien tenga el enlace puede ver la página (y, en shared, guardar datos en ella) hasta que caduque. Dalo solo a quien deba usarla.

Guardar datos desde la página

Doconda añade window.doconda.db a la página. Guarda JSON por colección y clave:
  • Nombres de colección y clave: letras, números, _, - o . (hasta 64).
  • Cada registro, hasta 16 KB de JSON; cada artifact, hasta 5.000 registros.
  • Por artifact y minuto: hasta 1.200 lecturas y 120 escrituras. Por encima, 429 rate_limited.
  • La página se abre aislada: no tiene cookies ni localStorage, y no puede leer nada de tu web ni de Doconda. Para guardar, usa doconda.db.

Leer los datos desde tu programa

Proyectos que no guardan contenido

Si el proyecto tiene el guardado desactivado (o la petición lleva store: false), un artifact solo puede ser local, y Doconda no lo aloja: se entrega como un fichero artifact.html para que lo subas a tu web (a los 15 minutos lo borramos). Sus datos se quedan en el navegador de cada visitante.

Región

Un artifact vive en la región de su proyecto, igual que los demás documentos: su página y sus datos no salen de ella.