O que Frontend Slides faz?
Crie apresentações HTML ricas em animações, com zero dependências, que rodam completamente no navegador.
Inspirado pela abordagem de exploração visual apresentada no trabalho de zarazhangrui (crédito: @zarazhangrui).
Quando Ativar
- Criar um deck para palestra, pitch, workshop ou apresentação interna
- Converter slides
.pptou.pptxem uma apresentação HTML - Melhorar o layout, movimento ou tipografia de uma apresentação HTML existente
- Explorar estilos de apresentação com um usuário que ainda não sabe sua preferência de design
Inegociáveis
- Zero dependências: padrão é um único arquivo HTML autocontido com CSS e JS inline.
- Ajuste à janela de visualização é obrigatório: cada slide deve caber em uma única janela de visualização, sem rolagem interna.
- Mostre, não conte: use prévias visuais em vez de questionários abstratos de estilo.
- Design diferenciado: evite decks genéricos com gradiente roxo, Inter sobre fundo branco e com aparência de template.
- Qualidade de produção: mantenha o código comentado, acessível, responsivo e com bom desempenho.
Antes de gerar, leia STYLE_PRESETS.md para a base CSS segura para janela de visualização, limites de densidade, catálogo de presets e pegadinhas de CSS.
Fluxo de Trabalho
1. Detectar Modo
Escolha um caminho:
- Nova apresentação: usuário tem um tópico, anotações ou um rascunho completo
- Conversão de PPT: usuário tem
.pptou.pptx - Melhoria: usuário já tem slides HTML e deseja melhorias
2. Descobrir Conteúdo
Pergunte apenas o mínimo necessário:
- propósito: pitch, ensino, palestra em conferência, atualização interna
- duração: curta (5-10), média (10-20), longa (20+)
- estado do conteúdo: texto finalizado, anotações básicas, apenas o tópico
Se o usuário tiver conteúdo, peça para colá-lo antes da estilização.
3. Descobrir Estilo
Padrão é exploração visual.
Se o usuário já souber o preset desejado, pule as prévias e use-o diretamente.
Caso contrário:
- Pergunte qual sentimento o deck deve criar: impressionado, energizado, focado, inspirado.
- Gere 3 arquivos de prévia de slide único em
.ecc-design/slide-previews/. - Cada prévia deve ser autocontida, mostrar tipografia/cor/movimento claramente e manter-se abaixo de aproximadamente 100 linhas de conteúdo de slide.
- Pergunte ao usuário qual prévia manter ou quais elementos misturar.
Use o guia de presets em STYLE_PRESETS.md ao mapear o humor para o estilo.
4. Construir a Apresentação
Gere:
presentation.html[nome-da-apresentacao].html
Use uma pasta assets/ apenas quando o deck contiver imagens extraídas ou fornecidas pelo usuário.
Estrutura necessária:
- seções semânticas de slide (
section) - uma base CSS segura para janela de visualização de
STYLE_PRESETS.md - propriedades personalizadas CSS para valores de tema
- uma classe controladora de apresentação para navegação por teclado, roda e toque
Intersection Observerpara animações de revelação- suporte a
prefers-reduced-motion
5. Aplicar Ajuste à Janela de Visualização
Trate isso como uma validação rigorosa.
Regras:
- cada
.slidedeve usarheight: 100vh; height: 100dvh; overflow: hidden; - toda tipografia e espaçamento devem escalar com
clamp() - quando o conteúdo não couber, divida em vários slides
- nunca resolva o estouro diminuindo o texto abaixo de tamanhos legíveis
- nunca permita barras de rolagem dentro de um slide
Use os limites de densidade e o bloco CSS obrigatório em STYLE_PRESETS.md.
6. Validar
Verifique o deck finalizado nestes tamanhos:
- 1920x1080
- 1280x720
- 768x1024
- 375x667
- 667x375
Se houver automação de navegador disponível, use-a para verificar se nenhum slide estoura e se a navegação por teclado funciona.
7. Entregar
Na entrega:
- exclua os arquivos de prévia temporários, a menos que o usuário queira mantê-los
- abra o deck com o abridor adequado à plataforma, quando útil
- resuma o caminho do arquivo, o preset usado, a contagem de slides e os pontos fáceis de personalização do tema
Use o abridor correto para o sistema operacional atual:
- macOS:
open file.html - Linux:
xdg-open file.html - Windows:
start "" file.html
Conversão de PPT / PPTX
Para conversão de PowerPoint:
- Prefira
python3compython-pptxpara extrair texto, imagens e anotações. - Se
python-pptxnão estiver disponível, pergunte se deve instalá-lo ou recorrer a um fluxo de trabalho manual/baseado em exportação. - Preserve a ordem dos slides, as anotações do apresentador e os ativos extraídos.
- Após a extração, execute o mesmo fluxo de trabalho de seleção de estilo de uma nova apresentação.
Mantenha a conversão multiplataforma. Não dependa de ferramentas exclusivas do macOS quando o Python pode fazer o trabalho.
Requisitos de Implementação
HTML / CSS
- Use CSS e JS inline, a menos que o usuário explicitamente queira um projeto com vários arquivos.
- Fontes podem vir do Google Fonts ou Fontshare.
- Prefira fundos atmosféricos, hierarquia de tipos forte e uma direção visual clara.
- Use formas abstratas, gradientes, grades, ruído e geometria em vez de ilustrações.
JavaScript
Inclua:
- navegação por teclado
- navegação por toque / swipe
- navegação por roda do mouse
- indicador de progresso ou índice do slide
- gatilhos de animação ao entrar
Acessibilidade
- use estrutura semântica (
main,section,nav) - mantenha contraste legível
- suporte navegação apenas por teclado
- respeite
prefers-reduced-motion
Limites de Densidade de Conteúdo
Use estes máximos, a menos que o usuário peça explicitamente slides mais densos e a legibilidade ainda seja mantida:
| Tipo de slide | Limite |
|---|---|
| Título | 1 título + 1 subtítulo + tagline opcional |
| Conteúdo | 1 título + 4-6 marcadores ou 2 parágrafos curtos |
| Grade de recursos | Máximo de 6 cartões |
| Código | Máximo de 8-10 linhas |
| Citação | 1 citação + atribuição |
| Imagem | 1 imagem limitada pela janela de visualização |
Anti-Padrões
- gradientes genéricos de startup sem identidade visual
- decks com fontes do sistema, a menos que intencionalmente editoriais
- longas paredes de marcadores
- blocos de código que precisam de rolagem
- caixas de conteúdo com altura fixa que quebram em telas curtas
- funções CSS negadas inválidas como
-clamp(...)
Skills ECC Relacionadas
frontend-patternspara padrões de componente e interação em torno do deckliquid-glass-designquando uma apresentação intencionalmente adota a estética de vidro da Applee2e-testingse você precisar de verificação automatizada no navegador para o deck final
Lista de Verificação de Entrega
- a apresentação funciona a partir de um arquivo local em um navegador
- cada slide cabe na janela de visualização sem rolagem
- o estilo é diferenciado e intencional
- a animação é significativa, não ruidosa
- a redução de movimento é respeitada
- os caminhos dos arquivos e os pontos de personalização são explicados na entrega