Frontend Slides
Crea presentaciones HTML ricas en animaciones y sin dependencias 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 charla, propuesta, taller o presentación interna
- Convertir diapositivas
.ppto.pptxen una presentación HTML - Mejorar una presentación HTML existente en diseño, movimiento o tipografía
- Explorar estilos de presentación con un usuario que aún no conoce su preferencia de diseño
Innegociables
- Sin dependencias: por defecto, un solo archivo HTML autónomo con CSS y JS inline.
- Ajuste al viewport obligatorio: cada diapositiva debe caber en 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 blanco, y presentaciones con plantillas predecibles.
- Calidad de producción: mantener el código comentado, accesible, responsivo y eficiente.
Antes de generar, lee STYLE_PRESETS.md para la base CSS segura para viewport, límites de densidad, catálogo de estilos 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 mejorarlas
2. Descubrir Contenido
Pregunta solo lo mínimo necesario:
- propósito: propuesta, enseñanza, charla de conferencia, actualización interna
- extensión: corta (5-10), media (10-20), larga (20+)
- estado del contenido: copia terminada, notas aproximadas, solo tema
Si el usuario tiene contenido, pídele que lo pegue antes de estilizar.
3. Descubrir Estilo
Por defecto, usar exploración visual.
Si el usuario ya conoce el estilo predefinido deseado, saltar las vistas previas y usarlo directamente.
De lo contrario:
- Preguntar qué sensación debe crear la presentación: impresionado, con energía, enfocado, inspirado.
- Generar 3 archivos de vista previa de una diapositiva en
.ecc-design/slide-previews/. - Cada vista previa debe ser autónoma, mostrar claramente tipografía/color/movimiento y tener menos de aproximadamente 100 líneas de contenido de diapositiva.
- Preguntar al usuario qué vista previa conservar o qué elementos combinar.
Usar la guía de estilos en STYLE_PRESETS.md al asociar el estado de ánimo con el estilo.
4. Construir la Presentación
Generar ya sea:
presentation.html[nombre-de-presentacion].html
Usar 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 el viewport desde
STYLE_PRESETS.md - propiedades personalizadas de 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 al entrar
- soporte para movimiento reducido
5. Asegurar el Ajuste al Viewport
Tratar esto como una puerta estricta.
Reglas:
- cada
.slidedebe usarheight: 100vh; height: 100dvh; overflow: hidden; - todo el texto y 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
Usar los límites de densidad y el bloque CSS obligatorio en STYLE_PRESETS.md.
6. Validar
Verificar la presentación terminada en estos tamaños:
- 1920×1080
- 1280×720
- 768×1024
- 375×667
- 667×375
Si hay automatización del navegador disponible, usarla para verificar que ninguna diapositiva se desborda y que la navegación por teclado funciona.
7. Entregar
Al momento de la entrega:
- eliminar los archivos de vista previa temporales a menos que el usuario quiera conservarlos
- abrir la presentación con el abridor apropiado de la plataforma cuando sea útil
- resumir la ruta del archivo, el estilo usado, el número de diapositivas y los puntos fáciles de personalización del tema
Usar el abridor correcto para el SO actual:
- macOS:
open archivo.html - Linux:
xdg-open archivo.html - Windows:
start "" archivo.html
Conversión PPT / PPTX
Para la conversión de PowerPoint:
- Preferir
python3conpython-pptxpara extraer texto, imágenes y notas. - Si
python-pptxno está disponible, preguntar si instalarlo o recurrir a un flujo manual basado en exportación. - Conservar el orden de las diapositivas, las notas del orador y los activos extraídos.
- Después de la extracción, ejecutar el mismo flujo de selección de estilo que en una presentación nueva.
Mantener la conversión multiplataforma. No depender de herramientas solo de macOS cuando Python puede hacer el trabajo.
Requisitos de Implementación
HTML / CSS
- Usar CSS y JS inline a menos que el usuario solicite explícitamente un proyecto con múltiples archivos.
- Las fuentes pueden venir de Google Fonts o Fontshare.
- Preferir fondos atmosféricos, jerarquía tipográfica fuerte y una dirección visual clara.
- Usar formas abstractas, gradientes, cuadrículas, ruido y geometría en lugar de ilustraciones.
JavaScript
Incluir:
- navegación por teclado
- navegación táctil / deslizamiento
- navegación con rueda del ratón
- indicador de progreso o índice de diapositiva
- disparadores de animación al entrar en la vista
Accesibilidad
- usar estructura semántica (
main,section,nav) - mantener el contraste legible
- soportar navegación solo con teclado
- respetar
prefers-reduced-motion
Límites de Densidad de Contenido
Usar estos máximos a menos que el usuario solicite 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 | máximo 6 tarjetas |
| Código | máximo 8-10 líneas |
| Cita | 1 cita + atribución |
| Imagen | 1 imagen limitada por el viewport |
Anti-patrones
- gradientes de inicio genéricos sin identidad visual
- presentaciones con fuentes del sistema a menos que sea intencionadamente 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 prestada intencionadamente la estética de vidrio de Applee2e-testingsi se necesita 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 encaja en el viewport sin desplazamiento
- el estilo es distintivo e intencionado
- la animación es significativa, no ruidosa
- se respeta el movimiento reducido
- las rutas de archivo y los puntos de personalización se explican en la entrega