Communitygithub.com

Funnyhust/POC_Kaenx_Creator

Cria páginas de destino com slider/slideshow integrado para apresentações de compartilhamento de conhecimento. Use SOMENTE quando o usuário solicitar explicitamente TANTO página de destino QUANTO funcionalidade de slider/slideshow juntos. NÃO para páginas de destino comuns ou sliders independentes.

O que é POC_Kaenx_Creator?

Este skill cria landing pages que se transformam em apresentações em tela cheia com navegação por teclado, efeitos de vidro (glassmorphism) e animações profissionais. É ideal para projetos que exigem uma combinação de página de destino e modo slideshow, permitindo alternar entre os dois modos com animações suaves. O skill é baseado em Vite, React, Tailwind CSS v4, Lucide React e Framer Motion, e inclui componentes prontos para container de slides, slide individual e um hook personalizado para navegação por teclado. Para usar, basta criar um projeto Vite com TypeScript, instalar as dependências listadas e configurar o tema Tailwind CSS com cores oklch para gradientes vibrantes e efeitos de vidro. O skill também oferece padrões de animação, práticas recomendadas de acessibilidade e desempenho, e um diagrama de decisão para orientar a implementação.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Funnyhust/POC_Kaenx_Creator/tree/HEAD/.agent/skills/landing-page-slider

Perguntar na sua IA favorita

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

Documentação

Slider de Página de Destino

Crie páginas de destino lindas que se transformam em apresentações em tela cheia com navegação por teclado, efeitos de vidro (glassmorphism) e animações profissionais.

Quando Usar Este Skill

[!IMPORTANT] Este skill é para projetos que precisam de TANTO página de destino QUANTO funcionalidade de slider/slideshow combinados.

  • Usuário pede explicitamente por "página de destino com slider" ou "página de destino para apresentação"
  • Construção de páginas de compartilhamento de conhecimento com modo slideshow
  • Criação de sites de marketing que podem alternar para o modo de apresentação
  • NÃO para: Páginas de destino comuns, carrosséis/sliders independentes, slideshows simples

Pilha Tecnológica

TecnologiaVersãoPropósito
Vite5+Ferramenta de build
React18+Framework de UI
Tailwind CSSv4Estilização (CSS-first)
Lucide ReactÚltimaÍcones profissionais
Framer MotionÚltimaAnimações

Início Rápido

Passo 1: Criar Projeto

npm create vite@latest my-landing -- --template react-ts
cd my-landing
npm install

Passo 2: Instalar Dependências

npm install tailwindcss @tailwindcss/vite lucide-react framer-motion

Passo 3: Configurar Vite

// vite.config.ts
import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
import tailwindcss from '@tailwindcss/vite'

export default defineConfig({
  plugins: [react(), tailwindcss()],
})

Passo 4: Configurar Tailwind CSS v4

/* src/index.css */
@import "tailwindcss";

@theme {
  /* Cores de gradiente primárias usando oklch para exibição P3 */
  --color-primary: oklch(0.65 0.18 250);
  --color-secondary: oklch(0.55 0.15 280);
  --color-accent: oklch(0.75 0.2 160);
  
  /* Cores de efeito vidro */
  --color-glass-bg: oklch(0.15 0.02 260 / 0.6);
  --color-glass-border: oklch(1 0 0 / 0.1);
  
  /* Animações */
  --animate-slide-in: slide-in 0.5s ease-out;
  --animate-fade-up: fade-up 0.6s ease-out;
  --animate-glow: glow 2s ease-in-out infinite;
}

@keyframes slide-in {
  from { transform: translateX(100%); opacity: 0; }
  to { transform: translateX(0); opacity: 1; }
}

@keyframes fade-up {
  from { transform: translateY(20px); opacity: 0; }
  to { transform: translateY(0); opacity: 1; }
}

@keyframes glow {
  0%, 100% { box-shadow: 0 0 20px oklch(0.65 0.18 250 / 0.3); }
  50% { box-shadow: 0 0 40px oklch(0.65 0.18 250 / 0.6); }
}

Componentes Principais

1. Container do Slider

Componente principal que gerencia o modo de apresentação e navegação entre slides.

Principais recursos:

  • Alternar entre página de destino e modo de apresentação
  • Rastrear o índice do slide atual
  • Gerenciar animações entre slides
  • Suporte a tela cheia

2. Componente de Slide

Seções de conteúdo individuais que se tornam slides em tela cheia.

Principais recursos:

  • Áreas de conteúdo (título, descrição, visuais)
  • Animações de entrada/saída
  • Estilo de cartão com efeito vidro

3. Hook de Navegação por Teclado

Hook personalizado para atalhos de teclado.

TeclaAção
← / →Navegar slides
EspaçoPróximo slide
EscapeSair da apresentação
FAlternar tela cheia
PAlternar modo de apresentação

Padrões de Efeito Vidro

Cartão com Desfoque

<div className="
  bg-glass-bg 
  backdrop-blur-xl 
  border border-glass-border
  rounded-2xl 
  shadow-2xl
">
  {/* conteúdo */}
</div>

Orbes Gradientes (Fundo)

<div className="absolute inset-0 overflow-hidden -z-10">
  <div className="
    absolute -top-40 -right-40 w-80 h-80 
    bg-primary/30 rounded-full blur-3xl
  " />
  <div className="
    absolute -bottom-40 -left-40 w-80 h-80 
    bg-secondary/30 rounded-full blur-3xl
  " />
</div>

Padrões de Animação

Filhos Escalonados (Framer Motion)

const container = {
  hidden: { opacity: 0 },
  show: {
    opacity: 1,
    transition: { staggerChildren: 0.1 }
  }
}

const item = {
  hidden: { y: 20, opacity: 0 },
  show: { y: 0, opacity: 1 }
}

<motion.div variants={container} initial="hidden" animate="show">
  {items.map(i => <motion.div key={i} variants={item} />)}
</motion.div>

Transições de Slide

<AnimatePresence mode="wait">
  <motion.div
    key={currentSlide}
    initial={{ x: 100, opacity: 0 }}
    animate={{ x: 0, opacity: 1 }}
    exit={{ x: -100, opacity: 0 }}
    transition={{ duration: 0.3, ease: "easeOut" }}
  >
    {slides[currentSlide]}
  </motion.div>
</AnimatePresence>

Melhores Práticas

Excelência Visual

  1. Harmonia de Cores - Use cores oklch para gradientes consistentes e vibrantes
  2. Camadas de Profundidade - Combine desfoque + transparência + bordas sutis
  3. Movimento com Propósito - Anime para guiar a atenção, não para distrair
  4. Modo Escuro Primeiro - Efeito vidro brilha em fundos escuros

Desempenho

  1. Carregamento Preguiçoso - Carregue o conteúdo do slide sob demanda
  2. will-change - Adicione para elementos animados
  3. Reduzir Movimento - Respeite prefers-reduced-motion

Acessibilidade

  1. Foco Visível - Indicadores de foco claros no modo de apresentação
  2. Navegação por Teclado - Suporte completo a teclado (já embutido)
  3. Rótulos ARIA - Rotule os controles de navegação

Árvore de Decisão

O que você precisa?
├── Novo projeto de página de destino
│   └── Siga o Início Rápido (Passos 1-4)
├── Adicionar slider a um app React existente
│   └── Copie o componente Slider + hook
├── Personalizar estilo visual
│   └── Modifique o bloco @theme no CSS
└── Alterar atalhos de teclado
    └── Edite o hook useKeyboard

Exemplos e Recursos

Exemplos

Erros Comuns

ErroSolução
Desfoque não funcionaCertifique-se de que o pai tem position: relative ou overflow: hidden
Animações instáveisAdicione will-change: transform aos elementos animados
Cores parecem desbotadasUse oklch para suporte a gamute mais amplo
Teclado não funcionaVerifique se o foco está no elemento container

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas