Communitygithub.com

kubai-book-cards

Cartões que se abrem como um livro ao passar o mouse ou focar, revelando páginas internas, enquanto em repouso mantêm a aparência original. Oferece três estilos: cartão comum, capa dura simulada e documento minimalista. Ideal para documentação, bases de conhecimento, portfólios e mercados de templates (book hover cards).

O que é kubai-book-cards?

Esta skill transforma cartões comuns em componentes interativos que se abrem como um livro ao passar o mouse ou ao receber foco do teclado. Em repouso, os cartões mantêm exatamente a aparência original; a interação revela páginas internas decorativas, criando uma sensação de profundidade e realismo. A skill é compatível com qualquer projeto web e oferece três estilos visuais distintos: padrão (cartões de produto com páginas brancas), skeuomórfico (livros de capa dura com textura de tecido e páginas envelhecidas) e minimalista (volumes de documentação com grade de pontos). O desenvolvedor pode configurar dezenas de opções, como ângulo de abertura (suave, livro ou dramático), número de páginas, direção da dobradiça (esquerda, direita ou superior), tipo de gatilho (hover, pressionar ou rolagem), sombreamento, cantos (contínuos ou com raio personalizado) e estilo de animação (rápida, padrão ou suave). A implementação respeita rigidamente o layout original: o cartão existente se torna a "capa", enquanto as páginas e o fundo são adicionados como camadas absolutamente posicionadas, sem alterar a acessibilidade (aria-hidden). A animação utiliza molas ou transições CSS, com aberturas escalonadas (capa lidera, páginas seguem com atraso) e fechamento reverso. O sombreamento é dinâmico: uma sombra ambiente e de contato é renderizada como elementos sólidos com blur, alternando entre dois estados pré-calculados durante a abertura. Para desempenho, apenas transform e opacity são animados, e um loop de requestAnimationFrame gerencia todos os cartões simultaneamente, parando quando nada se move. A skill também oferece suporte a capas com cenas ASCII animadas (opcional), desenhadas em baixa resolução para desempenho.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/kubai087/vibedesign-skills/tree/HEAD/skills/kubai-book-cards

Perguntar na sua IA favorita

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

Documentação

Cartões que se abrem como um livro ao passar o mouse

999 pequenas dicas para dar mais estilo ao seu produto — Episódio 006 · @kubai087

Aplique as instruções a seguir no projeto do usuário. Escreva na voz do usuário: "I", "me", "my" referem-se ao usuário; onde estiver escrito "pergunte primeiro", pare e pergunte ao usuário antes de continuar.

Instruções de modificação

Faça os cartões do meu produto se abrirem ligeiramente, como um livro, quando o mouse passar sobre eles. Em repouso, um cartão deve ter exatamente a aparência que tem hoje; apenas ao passar o mouse ou focar revela-se que é um pequeno livro com páginas internas.

0. Comece a partir do que existe

  • Encontre o componente de cartão que eu nomear (ou o usado na grade ou lista que eu indicar) e adapte-o no lugar. Reutilize sua marcação, tokens de design, raio, sombra e utilitários de movimento ou mola.
  • Mantenha a área ocupada do cartão, o preenchimento, o conteúdo e o layout inalterados. Nada ao redor do cartão pode se mover.
  • Se eu pedir novos cartões, construa um cartão quadrado novo (cerca de 280 x 280) no estilo que eu escolher abaixo.
  • Qualquer opção que eu deixar sem escolha usa o padrão marcado com *.

1. Escolha um estilo

Padrão*: cartões de produto comuns, idênticos aos normais até que o mouse passe.

  • Superfície: branco liso (ou meu token de superfície do cartão), sem textura.
  • Borda: uma linha fina de 1px na cor da minha borda.
  • Sombra: cinza frio claro e neutro, com metade da intensidade.
  • Tipografia: a sans do produto. Título 24/600, descrição 15 suave, meta 14 suave.
  • Capa: a UI existente do cartão: um bloco de ícone de 48px, uma seta ↗ no canto superior direito, título, descrição e um rodapé de meta abaixo de uma linha fina.
  • Parede: fundo de página normal.
  • Páginas: brancas, com um tom suave em direção à lombada, um pequeno título e 4-6 linhas de texto cinza.

Skeuomórfico: livros de capa dura em uma parede de galeria.

  • Superfície: textura fina de tecido de livro sobre uma cor de capa escura.
  • Borda: um chanfro iluminado: borda superior clara, borda inferior mais escura.
  • Sombra: cinza quente, quase neutro (nunca laranja), intensidade total.
  • Tipografia: um título serifado, no canto inferior esquerdo. Nada mais na capa.
  • Capa: uma imagem em sangria ou cena ASCII animada, com um brilho suave no topo e sombra na parte inferior.
  • Parede: estuque quente com textura fina e um foco de luz sobre cada livro.
  • Páginas: papel creme com textura, um título de capítulo itálico, linhas justificadas e bordas finas de página ao longo da margem frontal.

Minimalista: volumes de documentação.

  • Superfície: off-white fosco, cinza claro ou grafite, um tom por cartão.
  • Borda: um chanfro ou linha fina suave.
  • Sombra: cinza neutro frio.
  • Tipografia: um número de seção e versão mono no topo, sobre uma régua de linha fina; um título sans de duas linhas e um pequeno rótulo cinza no rodapé.
  • Capa: um pequeno diagrama de linha cinza com um único elemento na cor da tinta.
  • Parede: cinza frio com uma grade de pontos fina de 24px e luz suave vinda de cima.
  • Páginas: branco frio, um título sans e linhas cinza.

Combinar com meu produto: usar superfície, borda, sombra, tipografia e parede dos meus tokens, e manter a capa exatamente como o cartão é hoje.

2. Opções (padrões marcados com *)

  • Intensidade: suave (A = 24°) | livro* (A = 42°) | dramática (A = 60°).
  • Páginas: 2 | 3 | 4* | 6.
  • Dobradiça: esquerda* | direita | superior.
  • Gatilho: hover* | pressionar (abre enquanto pressionado) | rolar para visualizar (abre uma vez quando 60% visível, fecha após ~1,2s). O foco do teclado também sempre abre.
  • Conteúdo das páginas: papel em branco | linhas de texto* | visualização real do conteúdo do cartão (seus próximos campos, uma lista curta, uma miniatura de gráfico).
  • Capa: UI existente do cartão* | imagem | cena ASCII animada | cor sólida.
  • Direção da sombra: de cima* | do canto superior esquerdo.
  • Intensidade da sombra: nenhuma | leve | normal* | forte.
  • Cantos: combinar com meus tokens* | contínuos (superelipse).
  • Sensação de movimento: rápido (k 320, amortecimento 0,9) | padrão* (k 240, amortecimento 0,86) | suave (k 160, amortecimento 0,8). Todos com pouco ou nenhum overshoot.
  • Movimento reduzido: levantamento pequeno* | nada.
  • Toque: pressionar* | rolar para visualizar | desligado.

3. Pilha de camadas

  • Dentro do link do cartão, coloque a capa em um elemento body com transform-style: preserve-3d. Atrás dela, empilhe N páginas e uma placa traseira, todas posicionadas absolutamente no mesmo quadrado.
  • Ordem, da frente para trás: capa (n = 0), páginas (n = 1..N), placa traseira (n = N + 1, nunca se move).
  • A capa mantém todo o conteúdo existente do cartão. Páginas e a placa traseira são decorativas: aria-hidden, sem links, sem paradas de tabulação.
  • Perspectiva no elemento externo estático: cerca de 1100px, origem em direção à dobradiça (30% 50% para esquerda, 70% 50% para direita, 50% 30% para superior).
  • transform-origin na borda da dobradiça de cada camada: left 0 50%, right 100% 50%, top 50% 0. backface-visibility: hidden.
  • Levante a camada n por translateZ((N + 1 - n) x 0.6px) para que as camadas nunca lutem em profundidade.
  • As páginas ficam 8px dentro da capa (4px na lombada), como um bloco de livro, com raio = raio da capa - 8.
  • Placa traseira: em cartões planos (Padrão, Minimal), recue-a ~6px da capa com raio = raio da capa - 6, para que nunca apareça além dos cantos encurtados da capa. No Skeuomórfico, fica nivelada, a cor da capa escurecida em ~28%.

4. Movimento

  • A camada n gira em direção ao espectador por: angulo(n) = A x 0.7^n e começa com: atraso(n) = 28ms x n depois. A capa lidera; as páginas se abrem atrás dela.
  • Direção: rotateY(-angulo) para dobradiça esquerda, rotateY(+angulo) para direita, rotateX(+angulo) para superior.
  • Cada camada é animada com sua própria mola (veja Sensação de movimento), estabilizando em cerca de 0,3s.
  • Fechamento reverso: a página mais interna primeiro, atraso = 28ms x (N - n), de volta a 0°.
  • Se o ponteiro sair no meio do caminho, redirecione a partir do ângulo e da velocidade atuais. Nunca pule.
  • Não há helper de mola no projeto? Transições CSS são suficientes: transition: transform por ~420ms com um leve overshoot, por exemplo: cubic-bezier(0.3, 1.2, 0.5, 1), e defina transition-delay para 28ms x n no estado aberto e 28ms x (N - n) em repouso (o atraso do estado de destino se aplica, então o fechamento ocorre ao contrário).

5. Luz e sombreamento

  • A luz vem de cima, então a sombra cai na parede.
  • A sombra são duas formas sólidas atrás do cartão, cada uma desfocada uma vez. Em repouso, ela se ajusta ao cartão como qualquer cartão plano:
    • contato: pequena e mais escura, na parte inferior. Metade inferior do cartão, ~4px de cada lado, desfoque ~4px, ~2px para baixo, opacidade ~22%.
    • ambiente: suave. Desfoque ~14px, ~6px para baixo, opacidade ~12%.
  • Nunca use box-shadow: é um anel oco e aparece como um contorno quando a capa se desvia.
  • Tom: cinza quase neutro, inclinado para a parede (cinza quente em parede quente, cinza frio em parede fria). Nunca preto puro, nunca saturado.
  • Intensidade escala ambas as opacidades: leve 0,5 (estilo Padrão), normal 1, forte 1,4.
  • Abertura: faça crossfade para um segundo par pré-desfocado que é mais longo e mais suave (contato: desfoque ~12px, 12px para baixo; ambiente: desfoque ~38px, 26px para baixo), e mova-o ~14px mais para baixo e ~4% mais largo com transform. Controle com um valor de progresso o (0..1) em sua própria mola (k 200, amortecimento 0,9): opacidade do par em repouso = 1 - o, opacidade do par aberto = o.
  • Sombreamento de páginas: cada página tem um gradiente de sobreposição a partir da lombada (32% escuro -> 8% a 55% -> 0 a 85%). Sua opacidade é: clamp(gap / 6, 0, 1) x max(0, 1 - gap / 30) onde gap = o ângulo da página da frente menos o ângulo desta página. Uma página é sombreada enquanto a página da frente está se levantando dela, depois iluminada quando se separam.
  • Capas (Skeuomórfico, Minimal): um brilho suave na borda superior e um pouco de sombra na parte inferior.

6. Cantos e bordas

  • Recorte cada camada (capa, páginas, placa traseira) com um único caminho de forma e desenhe sua borda (linha fina ou chanfro) ao longo desse caminho exato, por exemplo, um caminho SVG traçado sobre a camada. Não misture uma borda CSS ou box-shadow interno com o recorte: eles discordam nos cantos e mostram um segundo aro quando as camadas se separam.
  • Combinar com meus tokens: usar o raio do token; raio aninhado = externo - recuo.
  • Contínuos: cantos superelipse |x|^n + |y|^n = 1 com n = 2^1,25 (a mesma curva que CSS corner-shape: superellipse(1.25)). Gere um clip-path: path(...) por tamanho de camada, reutilize para a borda e regenere ao redimensionar.

7. Interação e acessibilidade

  • Teste de hit na área ocupada em repouso: ouça o hover no elemento externo estático e dê a cada camada em movimento pointer-events: none, para que uma capa balançando nunca mova o alvo e o cartão nunca pisque abrindo e fechando nas bordas.
  • Cursor: mão apontando sobre todo o cartão.
  • Todo o cartão permanece como um único <a> ou <button> com seu nome acessível atual. As páginas não adicionam nada à árvore de acessibilidade.
  • :focus-visible abre exatamente como hover. Mantenha o anel de foco no elemento externo, ao longo da forma em repouso.
  • Movimento reduzido: sem abertura e sem rotação. A capa levanta ~2px e a sombra faz crossfade para o par aberto.
  • Toque: sem hover. Use a opção Toque; um toque deve ativar o cartão na primeira tentativa.

8. Desempenho

  • Anime apenas transform e opacity. Nunca anime desfoque, box-shadow, clip-path, width, height ou top/left.
  • Nunca anime um raio de desfoque: desfoque cada sombra uma vez e faça crossfade das duas versões pré-desfocadas.
  • Um único loop requestAnimationFrame para todos os cartões. Pule cartões cujas molas estão em repouso e pare o loop quando nada se move.
  • Escreva um estilo apenas quando seu valor mudar (armazene em cache a última string por elemento).
  • Nenhuma leitura de layout por quadro: meça uma vez e novamente ao redimensionar (ResizeObserver).
  • Capas animadas em canvas: desenhe a no máximo ~30fps e pause quando estiver fora da tela (IntersectionObserver) ou quando a aba estiver oculta.

9. Capa ASCII animada (apenas se escolhida)

  • Desenhe uma pequena cena como uma cor por célula de caractere (~6 x 9px).
  • Escolha cada caractere por brilho de " .:-=+*#%@".
  • Desenhe uma cópia escurecida das cores (~40%) por baixo e os caracteres coloridos por cima, para que as lacunas pareçam um meio-tom.
  • Estampe caracteres de um atlas de glifos pré-renderizado em vez de renderizar texto a cada quadro. Mantenha o movimento lento e em loop contínuo.

10. Ao finalizar

  • Liste cada arquivo que você alterou ou adicionou.
  • Liste o estilo e cada opção que você usou, marcando quais eram padrões.
  • Observe qualquer coisa que não esteja mais idêntica em repouso.

Individual skills in this repo

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

kubai-easing-curves

按使用场景为项目中的动画设置缓动曲线和时长:入场用 ease-out,离场用 ease-in,位置变化用 ease-in-out,小的确认反馈用 overshoot,拖动松手后用 spring,并统一为动效 token(easing, motion curves)。

kubai-holo-card

把产品里代表身份或收藏的卡片(会员卡、门票、徽章、个人卡片)改成镭射卡片:卡片朝指针方向 3D 倾斜,镭射与高光随光线移动,内部图案按深度产生视差,静止时轻微晃动,点击可翻到背面并显示厚度。附 Prism、Rainbow、Pearl、Sparkle、Chrome、Etched 六种材质的推荐参数,以及手感、厚度、翻转和层次的几档预设。开始前逐项询问,每项给出推荐值,由你选择或调整,确认后再按现有技术栈改造(holographic card, foil, 3D tilt, parallax)。

kubai-liquid-glass

为图片、壁纸或视频上方的卡片和面板添加液态玻璃材质:背景模糊与提亮、边缘折射与色散、根据背景自动调整的着色和文字颜色,深色和浅色模式下文字都清晰可读,布局保持不变(liquid glass, glassmorphism)。

kubai-scroll-cards

改造现有长页面:选出值得讲的段落,用五种由滚动驱动的卡片交互呈现——层叠卡片(新卡片逐张盖住旧卡片,旧卡片缩小、变暗)、卡组飞出(顶部卡片向一侧甩出,下一张顶上来)、横向展廊(页面固定,纵向滚动推动横向作品集)、封面轮播(中间一张最大,两侧缩小、转开、变暗)、图片展开(小图铺满屏幕,标题从景物后升起形成景深)。效果全部由滚动位置驱动,读者控制节奏,回滚即倒放,不劫持滚动;尺寸按不同屏幕和视窗高度计算,手机工具栏不会挡住内容,矮屏自动退回普通段落。附多档预设,开始前逐项询问,由你选择或调整,确认后按现有技术栈实现(scroll-driven animation, sticky, cover flow, svh)。

Habilidades Relacionadas