Communitygithub.com

kubai-book-cards

Las tarjetas se abren como un libro al pasar el cursor o al enfocarse, mostrando páginas interiores. Sin interacción, mantienen su apariencia original. Ofrece tres estilos: tarjetas normales, libros de tapa dura y documentos minimalistas. Ideal para documentación, bases de conocimiento, portafolios y mercados de plantillas (book hover cards).

¿Qué es kubai-book-cards?

Este skill transforma tarjetas de producto estándar en tarjetas con efecto de libro: al pasar el cursor o al recibir foco, la cubierta se levanta y se despliegan varias páginas interiores, como un libro real. Está pensado para desarrolladores que buscan añadir un detalle visual atractivo y de alta calidad a sus interfaces, compatible con cualquier framework web (React, Vue, Svelte, vanilla JS, etc.) y con un sistema de diseño existente. El skill modifica directamente el componente de tarjeta que el usuario indique, conservando su estructura, tokens de diseño, sombras y animaciones. Permite elegir entre tres estilos predefinidos: tarjetas normales (por defecto), libros de tapa dura (skeuomorphic) y documentos minimalistas. Además, ofrece numerosas opciones de personalización: ángulo de apertura, número de páginas, bisagra (izquierda, derecha o arriba), activación por hover, presión o scroll, contenido de las páginas, dirección y fuerza de la sombra, tipo de esquinas y sensación del movimiento. La implementación es técnica y detallada, usando transformaciones 3D, capas apiladas con `translateZ`, sombras pre-difuminadas y animaciones con resortes o transiciones CSS para un rendimiento óptimo. Incluye consideraciones de accesibilidad (foco, `aria-hidden`, `pointer-events`) y rendimiento (animar solo transform y opacity, un solo bucle `requestAnimationFrame`).

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Tarjetas que se abren como un libro al pasar el cursor

999 pequeños trucos para darle más calidad a tu producto Vibe · N.º 006 · @kubai087

Realiza las siguientes modificaciones en el proyecto del usuario. Escríbelas en primera persona (yo, me, mi) y cuando algo requiera preguntar, detente y consulta al usuario antes de continuar.

Requisitos de la modificación

Haz que las tarjetas de mi producto se abran ligeramente, como un libro, al pasar el cursor. En reposo, la tarjeta debe verse exactamente igual que hoy; solo al pasar el cursor o al recibir foco se revela que es un pequeño libro con páginas en su interior.

0. Comienza desde lo que existe

  • Busca el componente de tarjeta que te nombre (o el que se usa en la cuadrícula o lista que te indique) y adáptalo directamente. Reutiliza su marcado, tokens de diseño, radio, sombra y utilidades de movimiento o resorte.
  • Mantén las dimensiones, el relleno, el contenido y la disposición de la tarjeta sin cambios. Nada alrededor de la tarjeta debe moverse.
  • Si te pido tarjetas nuevas en su lugar, crea una tarjeta cuadrada nueva (aproximadamente 280 × 280) en el estilo que elija a continuación.
  • Cualquier opción que no especifique usará el valor marcado con *.

1. Elige un estilo

Por defecto*: tarjetas de producto normales, idénticas a las habituales hasta que se pasa el cursor.

  • Superficie: blanco liso (o mi token de superficie de tarjeta), sin textura.
  • Borde: línea fina de 1 píxel en mi color de borde.
  • Sombra: gris neutro frío claro, a media intensidad.
  • Tipografía: la sans-serif del producto. Título 24/600, descripción 15 atenuada, metadatos 14 atenuados.
  • Portada: la interfaz de tarjeta existente: un icono de 48 píxeles, una flecha ↗ en la parte superior derecha, título, descripción y un pie de metadatos debajo de una línea fina.
  • Pared: mi fondo de página normal.
  • Páginas: blancas, con un tono tenue hacia el lomo, un pequeño encabezado y 4-6 líneas de texto gris.

Skeuomorphic: libros de tapa dura en una galería de pared.

  • Superficie: grano fino de tela de libro sobre un color de cubierta profundo.
  • Borde: bisel iluminado: borde superior brillante, pie más oscuro.
  • Sombra: gris cálido, casi neutro (naranja nunca), a máxima intensidad.
  • Tipografía: un título serif en la parte inferior izquierda. Nada más en la portada.
  • Portada: una imagen a sangre o una escena ASCII animada, con un brillo suave en la parte superior y sombra en el pie.
  • Pared: yeso cálido con grano fino y un foco sobre cada libro.
  • Páginas: papel crema con grano, un encabezado de capítulo en cursiva, líneas justificadas y bordes de página finos a lo largo del canto frontal.

Minimalista: volúmenes de documentación.

  • Superficie: blanco roto, gris claro o grafito, un tono por tarjeta.
  • Borde: un bisel tenue o línea fina.
  • Sombra: gris neutro frío.
  • Tipografía: un número de sección y versión en mono, sobre una regla fina; un título sans-serif de dos líneas y una pequeña etiqueta gris en el pie.
  • Portada: un pequeño diagrama de líneas gris con un solo elemento en el color de tinta.
  • Pared: gris frío con una cuadrícula de puntos fina de 24 píxeles y luz suave desde arriba.
  • Coincidir con mi producto: toma la superficie, el borde, la sombra, la tipografía y la pared de mis tokens, y mantén la portada exactamente como está hoy.

2. Opciones (los valores por defecto están marcados con *)

  • Intensidad: sutil (A = 24°) | libro* (A = 42°) | dramática (A = 60°).
  • Páginas: 2 | 3 | 4* | 6.
  • Bisagra: izquierda* | derecha | arriba.
  • Activación: hover* | presión (abrir mientras se presiona) | desplazamiento a la vista (abrir una vez cuando esté visible al 60%, cerrar después de ~1,2 s). El foco del teclado también lo abre siempre.
  • Las páginas muestran: papel en blanco | líneas de texto* | contenido real de vista previa de la tarjeta (sus campos siguientes, una lista corta, una miniatura de gráfico).
  • Portada: interfaz de tarjeta existente* | imagen | escena ASCII animada | color sólido.
  • Dirección de la sombra: desde arriba* | desde arriba a la izquierda.
  • Intensidad de la sombra: ninguna | ligera | normal* | profunda.
  • Esquinas: coincidir con mis tokens* | continuas (superelipse).
  • Sensación del movimiento: rápido (k 320, amortiguación 0,9) | por defecto* (k 240, amortiguación 0,86) | suave (k 160, amortiguación 0,8). Todos apenas sobrepasan.
  • Movimiento reducido: elevación mínima* | nada.
  • Táctil: presión* | desplazamiento a la vista | desactivado.

3. Pila de capas

  • Dentro del enlace de la tarjeta, coloca la portada en un elemento body con transform-style: preserve-3d. Detrás, apila N páginas y un panel posterior, todos posicionados de forma absoluta en el mismo cuadrado.
  • Orden, de frente a atrás: portada (n = 0), páginas (n = 1..N), panel posterior (n = N + 1, nunca se mueve).
  • La portada conserva todo el contenido existente de la tarjeta. Las páginas y el panel posterior son decorativos: aria-hidden="true", sin enlaces, sin paradas de tabulación.
  • Perspectiva en el elemento estático exterior: aproximadamente 1100 píxeles, origen hacia la bisagra (30% 50% para izquierda, 70% 50% para derecha, 50% 30% para arriba).
  • transform-origin en el borde de la bisagra de cada capa: izquierda 0 50%, derecha 100% 50%, arriba 50% 0. backface-visibility: hidden.
  • Eleva la capa n con translateZ((N + 1 - n) * 0.6px) para que las capas nunca combatan en profundidad.
  • Las páginas se colocan 8 píxeles dentro de la portada (4 píxeles en el lomo), como un bloque de libro, con radio = radio de la portada - 8.
  • Panel posterior: en tarjetas planas (Por defecto, Minimalista), insértalo ~6 píxeles desde la portada con radio = radio de la portada - 6, para que nunca se asome más allá de las esquinas acortadas de la portada. En Skeuomorphic, va al ras, con el color de la portada oscurecido ~28%.

4. Movimiento

  • La capa n gira hacia el espectador en: ángulo(n) = A × 0,7^n y comienza con: retraso(n) = 28 ms × n después. La portada lidera; las páginas se abren en abanico detrás de ella.
  • Dirección: rotateY(-ángulo) para bisagra izquierda, rotateY(+ángulo) para derecha, rotateX(+ángulo) para arriba.
  • Cada capa se mueve con su propio resorte (ver Sensación del movimiento), estabilizándose en aproximadamente 0,3 segundos.
  • Cierre en orden inverso: la página más interna primero, retraso = 28 ms × (N - n), de vuelta a 0 grados.
  • Si el puntero sale a medio camino, redirige desde el ángulo y la velocidad actuales. Nunca saltes.
  • ¿No hay utilidad de resorte en el proyecto? Las transiciones CSS están bien: transición de transform durante ~420 ms con un ligero rebasamiento, por ejemplo, cubic-bezier(0.3, 1.2, 0.5, 1), y establece transition-delay a 28 ms × n en el estado abierto y 28 ms × (N - n) en reposo (se aplica el retraso del estado objetivo, por lo que el cierre se ejecuta en orden inverso).

5. Luz y sombreado

  • La luz proviene de arriba, por lo que la sombra cae hacia abajo en la pared.
  • La sombra son dos formas sólidas detrás de la tarjeta, cada una difuminada una vez. En reposo, se ajusta a la tarjeta como cualquier tarjeta plana:
    • contacto: pequeña y más oscura, en el pie. Mitad inferior de la tarjeta, ~4 píxeles hacia adentro desde cada lado, desenfoque ~4 píxeles, ~2 píxeles hacia abajo, ~22% de opacidad.
    • ambiental: tenue. Desenfoque ~14 píxeles, ~6 píxeles hacia abajo, ~12% de opacidad.
  • Nunca uses box-shadow: es un anillo hueco y se muestra como un contorno una vez que la portada se separa de él.
  • Tinte: gris casi neutro con un matiz hacia la pared (gris cálido sobre una pared cálida, gris frío sobre una fría). Nunca negro puro, nunca saturado.
  • La fuerza escala ambas opacidades: ligero 0,5 (estilo Por defecto), normal 1, profundo 1,4.
  • Apertura: fundido cruzado a un segundo par pre-difuminado que es más largo y suave (desenfoque de contacto ~12 píxeles, 12 píxeles hacia abajo; desenfoque ambiental ~38 píxeles, 26 píxeles hacia abajo), y muévelo ~14 píxeles más abajo y ~4% más ancho con transform. Impúlsalo con un valor de progreso o (0..1) en su propio resorte (k 200, amortiguación 0,9): opacidad del par en reposo 1 - o, opacidad del par abierto o.
  • Sombreado de las hojas: cada página tiene un gradiente superpuesto desde el lomo (32% oscuro -> 8% al 55% -> 0 al 85%). Su opacidad es: clamp(brecha / 6, 0, 1) * max(0, 1 - brecha / 30) donde brecha = el ángulo de la hoja delantera menos el ángulo de esta hoja. Una página se sombrea mientras la hoja delantera se está levantando de ella, luego se ilumina una vez que se separan.
  • Cubiertas (Skeuomorphic, Minimalista): un brillo suave en el borde superior y un poco de sombra en el pie.

6. Esquinas y bordes

  • Recorta cada capa (portada, páginas, panel posterior) a una forma de trazado, y dibuja su borde (línea fina o bisel) a lo largo de ese trazado exacto, por ejemplo, un trazado SVG trazado sobre la capa. No combines un borde CSS o box-shadow interno con el recorte: no coinciden en las esquinas y muestran un segundo borde cuando las capas se separan.
  • Coincidir con mis tokens: usa el radio del token; radio anidado = exterior - inserción.
  • Continuas: esquinas de superelipse |x|^n + |y|^n = 1 con n = 2^1.25 (la misma curva que corner-shape: superellipse(1.25) de CSS). Genera un clip-path: path(...) por tamaño de capa, reutilízalo para el borde y regenéralo al redimensionar.

7. Interacción y accesibilidad

  • Prueba de impacto en el área de reposo: escucha el hover en el elemento estático exterior y asigna a todas las capas en movimiento pointer-events: none, para que una portada que se balancea nunca mueva el objetivo y la tarjeta nunca parpadee al abrirse y cerrarse en sus bordes.
  • Cursor: una mano señalando sobre toda la tarjeta.
  • Toda la tarjeta sigue siendo un solo <a> o <button> con su nombre accesible actual. Las páginas no añaden nada al árbol de accesibilidad.
  • :focus-visible lo abre exactamente como hover. Mantén el anillo de foco en el elemento exterior, a lo largo de la forma en reposo.
  • Movimiento reducido: sin abanico y sin rotación. La portada se eleva ~2 píxeles y la sombra se funde al par abierto.
  • Táctil: no hay hover. Usa la opción Táctil; un toque debe seguir activando la tarjeta en el primer intento.

8. Rendimiento

  • Anima solo transform y opacity. Nunca anime blur, box-shadow, clip-path, width, height o top/left.
  • Nunca anime un radio de desenfoque: difumina cada sombra una vez y realiza un fundido cruzado entre las dos versiones pre-difuminadas.
  • Un solo bucle requestAnimationFrame para todas las tarjetas. Omite las tarjetas cuyos resortes están en reposo y detén el bucle cuando nada se mueva.
  • Escribe un estilo solo cuando su valor cambie (almacena en caché la última cadena por elemento).
  • Sin lecturas de diseño por fotograma: mide una vez, y de nuevo al redimensionar (ResizeObserver).
  • Portadas de lienzo animadas: dibuja a ~30 fps como máximo, y pausa cuando esté fuera de la pantalla (IntersectionObserver) o cuando la pestaña esté oculta.

9. Portada ASCII animada (solo si se elige)

  • Pinta una pequeña escena como un color por celda de carácter (~6 × 9 píxeles).
  • Elige cada carácter por brillo de " .:-=+*#%@".
  • Dibuja una copia atenuada de los colores (~40%) debajo y los caracteres coloreados encima, para que los huecos se lean como un medio tono.
  • Marca los caracteres desde un atlas de glifos pre-renderizado en lugar de diseñar texto cada fotograma. Mantén el movimiento lento y en bucle sin problemas.

10. Al finalizar

  • Enumera cada archivo que hayas cambiado o añadido.
  • Enumera el estilo y cada opción que hayas utilizado, marcando cuáles eran los valores por defecto.
  • Señala cualquier cosa que ya no se vea idéntica en reposo.

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)。

Skills relacionados