Communitygithub.com

deck-visuals

Gere renders 3D personalizados (Three.js), visualizações de dados editoriais (D3/SVG) e clipes de movimento em loop determinísticos (MP4) 100% localmente via Playwright/Chromium headless e ffmpeg.

O que é deck-visuals?

O Deck Visuals é um estúdio visual 100% local e orientado a código para gerar assets visuais de alta qualidade para apresentações. Ele lê tokens de marca (`window.BRAND_TOKENS`) e dados de visualização opcionais (`window.VISUAL_DATA`) injetados pelo sistema, eliminando a necessidade de chamadas de rede ou CDN. Suporta a renderização de PNGs retina transparentes ou clipes MP4 em loop contínuo, usando bibliotecas locais como Three.js e D3. É ideal para criar visuais 3D hero, diagramas de arquitetura, gráficos editoriais e planos de fundo animados, todos determinísticos e consistentes com a identidade visual do projeto. A saída pode ser usada diretamente no `deck-builder` para inserção em slides do DeckCraft.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SwePalm/deckcraft-skills/tree/HEAD/skills/deck-visuals

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Deck Visuals (Estúdio Visual 100% Local e Orientado a Código)

Cada visual gerado aqui é orientado a código, determinístico e personalizado com a marca:

  • Lê window.BRAND_TOKENS (injetado automaticamente a partir de tokens.json do deck-brand) e opcionalmente window.VISUAL_DATA (a partir de --data data.json).
  • Importa pacotes locais (three, d3) do servidor estático efêmero local — zero chamadas de rede externa ou CDN.
  • Renderiza PNGs transparentes nítidos em retina 2x (--mode png) ou clipes MP4 H.264 em loop contínuo (--mode mp4) prontos para insert.picture ou insert.video no deck-builder.

Guia de Seleção Visual (Narrativa Primeiro)

Necessidade NarrativaMelhor Ferramenta / Receita IntegradaSaída
Percorrer um diagrama ou ampliar um pilarDeckCraft Morph (deck-builder)Formas vetoriais nativas
Capa icônica / âncora conceitual / herói 3DThree.js (three-hero-orb.html)PNG transparente 2x ou MP4 em loop de 3–4s
Sistema em camadas / arquitetura de plataformaThree.js Isométrico (three-isometric-layers.html)PNG transparente 2x
Escala de esforço / maturidade / roadmap em fasesThree.js Terraços (three-ascending-steps.html)PNG transparente 2x
Modelo operacional de flywheel reutilizável / padrão NThree.js Flywheel (three-orbital-flywheel.html)MP4 em loop contínuo ou PNG 2x
Prova quantificada, tendências, rankings, comparaçõesD3 / SVG (editorial-chart.html)PNG transparente 2x
Walkthrough de produto / UIPalco de Perspectiva 3D HTML/CSS (Playwright)PNG transparente 2x
Fotografia real genuínaFoto fornecida pelo usuário (ou hook futuro opcional na nuvem)Imagem cortada

Renderizando um Asset Visual

1. PNG Retina Transparente (Still 3D, gráfico D3, diagrama SVG)

node skills/deck-visuals/scripts/render_visual.mjs \
  --scene skills/deck-visuals/references/recipes/three-hero-orb.html \
  --tokens build/brand/tokens.json \
  --width 600 --height 600 --scale 2 \
  --mode png --transparent \
  --out build/assets/hero-3d.png

2. MP4 em Loop Determinístico (Mesa giratória 3D, diagrama animado, shader)

Exponha window.renderFrame = (t) => { ... } onde t roda suavemente de 0 a 1 (envolva perfeitamente para que t=0 e t=1 coincidam!). Então execute:

node skills/deck-visuals/scripts/render_visual.mjs \
  --scene skills/deck-visuals/references/recipes/three-hero-orb.html \
  --tokens build/brand/tokens.json \
  --width 600 --height 600 --scale 1 \
  --mode mp4 --fps 30 --duration 4 \
  --out build/assets/hero-3d-loop.mp4

3. Passando Dados Personalizados para Gráficos/Diagramas

Passe --data caminho/para/chart-data.json — o executor injeta como window.VISUAL_DATA antes de o script da cena executar.

Regra de Qualidade: Inspecione Antes de Incorporar

Sempre inspecione cada PNG renderizado (ou quadro intermediário de vídeo) isoladamente antes de colocá-lo em um slide do DeckCraft:

  • Verifique a transparência e o anti-aliasing de borda (sem costura brusca de caixa delimitadora contra o fundo do slide).
  • Verifique se os rótulos do gráfico estão nítidos, sem sobreposição e com tamanho equivalente a pelo menos 11–12pt no tamanho alvo do retângulo do slide.
  • Verifique se todas as cores harmonizam com tokens.json.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Habilidades Relacionadas