Presentaciones comerciales como código: Slidev, Git y Cloudflare Pages
Nota de campo sobre un repositorio con 20 presentaciones comerciales en Slidev, publicadas desde Git en Cloudflare Pages: cómo se construye y cómo reducimos el tiempo de creación de cada presentación de horas a menos de 5 minutos.
Martín Pérez Brenlla
En septiembre estuve en Ciudad de México durante una semana para participar en una ronda de reuniones comerciales. Cada día tuve de media unas 4 reuniones con posibles clientes y partners. Preparé una presentación genérica en Google Slides sobre nuestra empresa y nuestro enfoque. Nuestros casos de éxito y qué buscábamos. Era una presentación sencilla. 14 slides directas al grano. Probablemente invertí entre 2 y 3 horas de una tarde en prepararla.
Sin embargo, al acabar y repasar las 20 reuniones que tendría en esa semana, me di cuenta de que iba a ser necesario crear más de una presentación porque el enfoque para partners y para clientes debía ser diferente y algunas reuniones requerían un enfoque más técnico que otras.
En otras ocasiones ya lo había hecho, copiar y pegar la presentación N veces y modificar cada una. Esta vez decidí hacerlo de forma diferente.
En este artículo cuento cómo utilicé Slidev, Git y Cloudflare Pages para crear un sistema que me permitió crear y publicar presentaciones comerciales en menos de 5 minutos y lo mejor de todo … “gratis”.
La idea
El concepto es muy simple. Todo surge con este proyecto open-source: slidevjs-slidev. Recordaba haber usado este proyecto para crear presentaciones como código pero ahora unido a la capacidad de los agentes de IA valía la pena revisarlo.
Lo que necesita, además de una base de presentación como código era una forma ágil de desplegarlo y un mecanismo que me permitiese generar nuevas presentaciones con mis agentes.
Cómo está construido
En Slidev, cada presentación es un Markdown con componentes Vue opcionales. Ya que el objetivo era generar presentaciones muy similares decidí estructurar el proyecto de forma que pudiera reutilizar componentes y estilos. Lo primero fue crear el CSS base que define los colores, tipografías y estilos globales. Esto fue instantáneo porque ya teníamos definido el sistema de diseño de Éutika para presentaciones.
El siguiente paso fue pedirle a un agente que realizase la conversión de la presentación existente a formato Slidev. Este paso también fue sencillo. El agente tenía acceso a la presentación original, al sistema de diseño de Éutika y la cli de slidev para generar el código.
Un subagente revisó la presentación una vez generada en slidev y realizó ajustes menores comparándola con la presentación original.
Otro subagente se encargó de crear una plantilla base para nuevas presentaciones, definiendo la estructura y los componentes comunes para ser reutilizados.
Slidev
Con esto ya teníamos una base sólida para generar nuevas presentaciones de manera ágil y consistente.
Creación de nuevas presentaciones
Ahora solo quedaba la adaptación del contenido y para ello utilizamos información de nuestra base de conocimiento interno y una investigación de cada cliente y partner, buscando noticias relevantes sobre ellos, que nos permitiesen armar una presentación completamente personalizada y actualizada.
La base de conocimiento es la pieza clave en esta ecuación porque es la que nos permite que los agentes que crean las presentaciones tengan todo el contexto necesario para entender lo que busca Éutika y cruzar esa información con lo que necesitan los clientes y partners.
Probémoslo en un entorno real
El código de estas presentaciones lo versionamos en GitHub en un repositorio privado. En este repositorio incluimos un AGENTS.md muy sencillo donde hacemos referencia al sistema de diseño de las presentaciones y a las herramientas que utilizamos.
Una vez ubicado en el repositorio y dado que el formato de salida es HTML decidí desplegarlo en Cloudflare Pages. Esta skill de Cloudflare es muy útil para automatizar el proceso.
¡Listo! Ya teníamos una versión desplegada y accesible en internet.
Acceso y seguridad
Aunque eran presentaciones sin datos confidenciales, decidí que el acceso debería ser controlado. Para ello utilicé Cloudflare Access, que nos permite controlar el acceso a los recursos de manera segura. Pero, si quiero que estas presentaciones sean visibles para terceros tengo dos opciones. Darle acceso solo a los correos autorizados para cada una de las presentaciones (que no conozco a priori) o hacerlas públicas pero con un identificador que no sea fácilmente adivinable.
Para ello creé un script que, para cada presentación, en el momento de generar el HTML, le asigna un identificador aleatorio de 24 caracteres. Este identificador se utiliza como parte de la URL de la presentación.
El script de build recorre la lista de presentaciones, valida que cada identificador tenga 24 caracteres alfanuméricos y compila cada una dentro de su propia ruta. El --base hace que los recursos de cada presentación se resuelvan bajo esa URL, y --without-notes deja fuera las notas del presentador:
for (const presentation of presentations) {
const publicPath = `/p/${presentation.publicId}`
spawnSync(slidev, [
'build', presentation.entry,
'--base', `${publicPath}/`,
'--out', resolve(output, 'p', presentation.publicId),
'--without-notes',
], { cwd: resolve(root, presentation.directory), stdio: 'inherit' })
}
En este punto tenemos las presentaciones públicas en URLs aleatorias. Con esto ya tenemos resuelto el problema pero sigue siendo un poco engorroso buscar presentación. Necesitamos un listado al que podamos acceder para ver todas las presentaciones y que en este caso sea privado.
Ahora sí entra en juego Cloudflare Access para limitar el acceso al listado de presentaciones solo a personal de Éutika (filtrado por dominio de correo). A través de este listado que además incluye el logo de cada empresa y partner ahora es sencillo acceder a cada presentación. Incluimos de paso un buscador en memoria que nos permite filtrar las presentaciones por nombre, empresa o partner.
Qué errores cometí en la primera iteración
El 404 que enseñaba el catálogo
Sin un 404.html en la raíz, Cloudflare Pages trata el sitio como una SPA y responde con el index.html raíz a cualquier ruta desconocida. Como /p/* tiene una excepción pública, cualquiera que pidiera una ruta inventada bajo /p/ recibía el catálogo protegido, con los enlaces de todos los decks. El arreglo fue copiar un 404.html en el build, y el commit explica la causa. La lección es que la excepción pública y el comportamiento por defecto de la plataforma se combinaron de una forma que no habíamos previsto.
Las notas del presentador en el build público
Las notas de Slidev acabaron en la versión publicada. Lo arreglamos con presenter: dev en la cabecera de cada deck y --without-notes en el build.
---
theme: default
title: Eutika × AMITI
presenter: dev # el modo presentador solo existe en desarrollo
---
Los agentes que habían creado las presentaciones habían dejado comentarios relevantes en las notas que no deberían estar en la versión pública.
Qué mejoras incluí para agilizar el proceso de revisión de las presentaciones
Por un momento, me vi tentado a no revisar las presentaciones en detalle. Es cierto que hice una revisión rápida para comprobar que no había errores importantes o expresiones típicas de un agente de IA. En 5 minutos tenía las 20 presentaciones generadas. Pero bueno, sabía que iba a tener muchos ratos muertos durante el viaje a CDMX por lo que si lo voy a revisar, por lo menos que sea de forma amigable.
La solución fue crear un sistema de comentarios que pudiese realizar directamente sobre la salida de las presentaciones generadas por Slidev. Le solicité a un agente que implementase un sistema sencillo de comentarios donde se registra en cada slide uno o varios comentarios y otro sistema un pelín más sofisticado donde puedo dibujar sobre la presentación para marcar áreas e incluir un comentario sobre esa zona. Cuando la revisión está completada un agente extrae esos comentarios y los incorpora a las presentaciones originales volviendo a generar las presentaciones.
Para enseñarlo uso una presentación ficticia, la de una propuesta a «Brétema Industrial», un fabricante inventado. Todas las cifras son inventadas.

Un botón en cada diapositiva
En modo desarrollo (pnpm dev) cada diapositiva muestra un botón discreto abajo a la derecha. No existe en el build ni en la exportación, así que nunca llega a la versión publicada.

Al pulsarlo se abre un panel que ya sabe en qué diapositiva estás y cómo se llama. Escribo el comentario como se lo diría a un compañero y lo guardo con ⌘+Enter.

Los comentarios pendientes de esa diapositiva se quedan a la vista y el botón muestra cuántos hay. Así puedo repasar una presentación entera sin perder el hilo de lo que ya he anotado.

Marcar una zona
A veces un comentario no basta porque el problema está en un punto concreto de la diapositiva. Para eso el panel tiene un botón «Marcar zona»: la diapositiva pasa a modo dibujo y arrastro un rectángulo sobre lo que quiero señalar.

Al guardar, la marca se queda sobre la diapositiva con el número del comentario. Así veo de un vistazo qué tengo señalado y dónde, sin abrir el panel.

La zona se guarda en fracciones del tamaño de la diapositiva (de 0 a 1), no en píxeles. Funciona igual con la ventana grande, pequeña o en un proyector, y el agente puede traducirla a «el rectángulo que cubre la cifra del lado derecho».
// ReviewButton.vue: el punto del puntero, relativo al lienzo de la diapositiva
function point(e: PointerEvent) {
const box = (e.currentTarget as HTMLElement).getBoundingClientRect()
return {
x: Math.min(1, Math.max(0, (e.clientX - box.left) / box.width)),
y: Math.min(1, Math.max(0, (e.clientY - box.top) / box.height)),
}
}
Lo que recibe el agente
Cada comentario se guarda en un fichero JSON dentro del repositorio, con la presentación, el número de diapositiva, su título, el texto y, si la he dibujado, la zona:
{
"id": 1,
"deck": "Eutika × Brétema Industrial · Caso ficticio",
"slide": 3,
"title": "Cada consulta obliga a reconstruir el pedido",
"text": "Este objetivo parece optimista. Añadir de dónde sale la cifra o decir que es una hipótesis a validar en el piloto.",
"area": { "x": 0.5375, "y": 0.4278, "w": 0.25, "h": 0.1167 },
"status": "pendiente"
}
Cuando termino de revisar le pido a un agente que lea los pendientes, edite el Markdown de cada presentación y vuelva a generarla. Al aplicar un comentario lo marca como aplicado y explica qué hizo en el campo respuesta:
{
"id": 1,
"status": "aplicado",
"respuesta": "Añadida la indicación «Hipótesis a validar» bajo la cifra de 10 minutos; el pie ya decía «objetivo por validar»."
}
Si un comentario no se puede aplicar tal cual, se queda como pendiente con la razón en respuesta. Eso me permite saber qué ha pasado con cada comentario sin releer la presentación entera.

El botón es un componente Vue y el guardado un plugin de Vite de unas 60 líneas. Los dos viven en una carpeta común y cada presentación solo necesita dos ficheros pequeños para activarlos. El primero le pasa al botón la diapositiva actual y solo lo pinta en desarrollo:
<!-- global-top.vue -->
<script setup lang="ts">
import { computed } from 'vue'
import { configs, useNav } from '@slidev/client'
import ReviewButton from '../../review/ReviewButton.vue'
const { currentSlideNo, currentSlideRoute, isPrintMode } = useNav()
const enabled = import.meta.env.DEV
const title = computed(() => currentSlideRoute.value?.meta?.slide?.title ?? '')
</script>
<template>
<ReviewButton v-if="enabled && !isPrintMode" :deck="configs.title" :slide="currentSlideNo" :title="title" />
</template>
El segundo registra el plugin que recibe los comentarios, que solo existe mientras corre el servidor de desarrollo:
// vite.config.ts
import { reviewViteConfig } from '../../review/plugin'
export default reviewViteConfig
¿Qué sigue?
Este sistema se ha convertido en la forma habitual de crear presentaciones en Éutika y HTML es el formato que utilizamos para compartir presentaciones y otros artefactos con nuestros clientes. El formato HTML nos permite compartir información en un soporte que es más fácil de consumir que un PDF y que permite una mayor interactividad y expresividad. Y en este caso usando agentes de IA con mucho menos esfuerzo.
Este proyecto sigue vivo y lo seguimos evolucionando. Se nos han ocurrido un montón de funcionalidades que podrían ser útiles y que están al alcance de una petición a un agente pero, al igual que hacemos en el resto de productos, implementamos solo lo justo y necesario. Es decir, hasta que nos surja una nueva necesidad que esté justificada no ampliaremos este proyecto. Una funcionalidad innecesaria no es más que complejidad y deuda técnica para el futuro.