Frontend Slides
Crea presentaciones HTML sin dependencias, ricas en animaciones, que se ejecutan completamente en el navegador.
Inspirado en el enfoque de exploración visual mostrado en el trabajo de zarazhangrui (crédito: @zarazhangrui).
Cuándo activarlo
- Crear una presentación para una charla, pitch, taller o presentación interna
- Convertir diapositivas
.ppto.pptxen una presentación HTML - Mejorar el diseño, la animación o la tipografía de una presentación HTML existente
- Explorar estilos de presentación con un usuario que aún no conoce su preferencia de diseño
Innegociables
- Cero dependencias: por defecto, un único archivo HTML autocontenido con CSS y JS en línea.
- Ajuste al viewport obligatorio: cada diapositiva debe caber dentro de un viewport sin desplazamiento interno.
- Mostrar, no contar: usar vistas previas visuales en lugar de cuestionarios de estilo abstractos.
- Diseño distintivo: evitar gradientes púrpura genéricos, Inter sobre fondo blanco o plantillas con aspecto prefabricado.
- Calidad de producción: mantener el código comentado, accesible, responsivo y eficiente.
Antes de generar, lee STYLE_PRESETS.md para conocer la base CSS segura para viewport, límites de densidad, catálogo de preajustes y errores comunes de CSS.
Flujo de trabajo
1. Detectar modo
Elige una ruta:
- Nueva presentación: el usuario tiene un tema, notas o un borrador completo
- Conversión PPT: el usuario tiene un archivo
.ppto.pptx - Mejora: el usuario ya tiene diapositivas HTML y desea mejoras
2. Descubrir contenido
Pregunta solo lo mínimo necesario:
- propósito: pitch, enseñanza, charla en conferencia, actualización interna
- duración: corta (5-10), media (10-20), larga (más de 20)
- estado del contenido: texto terminado, notas aproximadas, solo tema
Si el usuario tiene contenido, pídele que lo pegue antes de estilizar.
3. Descubrir estilo
Por defecto, exploración visual.
Si el usuario ya conoce el preajuste deseado, omite las vistas previas y úsalo directamente.
De lo contrario:
- Pregunta qué sensación debe crear la presentación: impresionado, energizado, concentrado, inspirado.
- Genera 3 archivos de vista previa de una diapositiva en
.ecc-design/slide-previews/. - Cada vista previa debe ser autocontenida, mostrar tipografía/color/animación claramente y mantenerse por debajo de aproximadamente 100 líneas de contenido de diapositiva.
- Pregunta al usuario qué vista previa conservar o qué elementos combinar.
Usa la guía de preajustes en STYLE_PRESETS.md al asignar el estado de ánimo al estilo.
4. Construir la presentación
Genera:
presentation.html[nombre-de-presentacion].html
Usa una carpeta assets/ solo cuando la presentación contenga imágenes extraídas o proporcionadas por el usuario.
Estructura requerida:
- secciones semánticas de diapositivas
- una base CSS segura para viewport de
STYLE_PRESETS.md - propiedades personalizadas CSS para los valores del tema
- una clase controladora de presentación para navegación por teclado, rueda y táctil
- Intersection Observer para animaciones de revelación
- soporte para movimiento reducido
5. Forzar ajuste al viewport
Trátalo como una puerta de validación estricta.
Reglas:
- cada
.slidedebe usarheight: 100vh; height: 100dvh; overflow: hidden; - toda la tipografía y el espaciado deben escalar con
clamp() - cuando el contenido no quepa, dividir en varias diapositivas
- nunca resolver el desbordamiento reduciendo el texto por debajo de tamaños legibles
- nunca permitir barras de desplazamiento dentro de una diapositiva
Usa los límites de densidad y el bloque CSS obligatorio en STYLE_PRESETS.md.
6. Validar
Verifica la presentación terminada en estos tamaños:
- 1920x1080
- 1280x720
- 768x1024
- 375x667
- 667x375
Si hay automatización del navegador disponible, úsala para verificar que ninguna diapositiva se desborda y que la navegación por teclado funciona.
7. Entregar
Al finalizar:
- elimina los archivos de vista previa temporales a menos que el usuario quiera conservarlos
- abre la presentación con el abridor adecuado para la plataforma cuando sea útil
- resume la ruta del archivo, el preajuste usado, el número de diapositivas y los puntos fáciles de personalización del tema
Usa el abridor correcto para el sistema operativo actual:
- macOS:
open file.html - Linux:
xdg-open file.html - Windows:
start "" file.html
Conversión PPT / PPTX
Para conversión de PowerPoint:
- Prefiere
python3conpython-pptxpara extraer texto, imágenes y notas. - Si
python-pptxno está disponible, pregunta si instalarlo o recurrir a un flujo de trabajo manual basado en exportación. - Conserva el orden de las diapositivas, las notas del orador y los recursos extraídos.
- Después de la extracción, ejecuta el mismo flujo de trabajo de selección de estilo que para una presentación nueva.
Mantén la conversión multiplataforma. No dependas de herramientas exclusivas de macOS cuando Python pueda hacer el trabajo.
Requisitos de implementación
HTML / CSS
- Usa CSS y JS en línea a menos que el usuario quiera explícitamente un proyecto de varios archivos.
- Las fuentes pueden venir de Google Fonts o Fontshare.
- Prefiere fondos atmosféricos, jerarquía tipográfica fuerte y una dirección visual clara.
- Usa formas abstractas, degradados, cuadrículas, ruido y geometría en lugar de ilustraciones.
JavaScript
Incluye:
- navegación por teclado
- navegación táctil / deslizamiento
- navegación con rueda del ratón
- indicador de progreso o índice de diapositivas
- disparadores de animación al entrar en vista
Accesibilidad
- usa estructura semántica (
main,section,nav) - mantén el contraste legible
- soporta navegación solo con teclado
- respeta
prefers-reduced-motion
Límites de densidad de contenido
Usa estos máximos a menos que el usuario pida explícitamente diapositivas más densas y la legibilidad se mantenga:
| Tipo de diapositiva | Límite |
|---|---|
| Título | 1 encabezado + 1 subtítulo + eslogan opcional |
| Contenido | 1 encabezado + 4-6 viñetas o 2 párrafos cortos |
| Cuadrícula de características | 6 tarjetas como máximo |
| Código | 8-10 líneas como máximo |
| Cita | 1 cita + atribución |
| Imagen | 1 imagen limitada por el viewport |
Antipatrones
- degradados genéricos de startup sin identidad visual
- presentaciones con fuente del sistema a menos que sea intencionalmente editorial
- muros largos de viñetas
- bloques de código que necesitan desplazamiento
- cajas de contenido con altura fija que se rompen en pantallas cortas
- funciones CSS negadas no válidas como
-clamp(...)
Habilidades ECC relacionadas
frontend-patternspara patrones de componentes e interacción alrededor de la presentaciónliquid-glass-designcuando una presentación toma intencionalmente la estética de vidrio de Applee2e-testingsi necesitas verificación automatizada del navegador para la presentación final
Lista de verificación de entrega
- la presentación se ejecuta desde un archivo local en un navegador
- cada diapositiva cabe en el viewport sin desplazamiento
- el estilo es distintivo e intencional
- la animación es significativa, no ruidosa
- se respeta el movimiento reducido
- las rutas de archivo y los puntos de personalización se explican al finalizar