🚀 Oferta especial: 60% OFF no CrazyStack - Últimas vagas!Garantir vaga →
🔧

Módulo 1 - Aula 2: Instalação e Configuração

Configurando o projeto e implementando o primeiro componente Cult UI

Duração
20 minutos
Dificuldade
Iniciante
Progresso
2/35 aulas

✅ O que você vai aprender:

  • • Entender a filosofia "copy-paste" do Cult UI
  • • Configurar utilitários avançados (cn, animations)
  • • Implementar seu primeiro componente prático
  • • Testar o componente com live preview
  • • Aplicar em exemplo de SaaS de restaurante

📦 Filosofia Copy-Paste do Cult UI

🎯 Por que Cult UI não é um pacote NPM?

Controle total: Você possui 100% do código. Pode modificar, adaptar e evoluir sem depender de atualizações externas.

Sem bloat: Apenas os componentes que você usa. Não há código desnecessário no seu bundle final.

Customização: Cada componente pode ser totalmente personalizado para suas necessidades específicas.

🔧 Estrutura de pastas para Cult UI

Estrutura do projeto

🎨 Utilitários avançados

💡 Função cn() aprimorada

Vamos expandir nossa função de utilitários para incluir variantes e animações:

lib/utils.ts

⚡ Tailwind Config para Cult UI

tailwind.config.js

✅ Configuração completa!

Agora você tem um setup robusto para trabalhar com Cult UI:

  • • Sistema de utilitários avançado (cn, animations, colors)
  • • Animações customizadas no Tailwind
  • • Estrutura de pastas organizada
  • • Sombras neumórficas pré-configuradas
  • • Pronto para implementar qualquer componente Cult UI

🎨 Primeiro Componente: Neumorph Button

🎯 Por que começar com botões?

Botões são fundamentais em qualquer interface. O Neumorph Button do Cult UI demonstra conceitos importantes como variantes, estados e animações suaves.

📋 Implementação completa

components/cult-ui/neumorph-button.tsx

🔍 Conceitos importantes

Neumorfismo:

Efeito visual que simula botões "pressionados" ou "elevados" usando sombras internas e externas.

forwardRef:

Permite que o componente passe referências para o elemento DOM, essencial para integração com formulários.

Variantes:

Sistema para diferentes estilos do mesmo componente, mantendo consistência visual.

Estados:

Loading, disabled, hover, active - todos os estados interativos tratados adequadamente.

🎨 Exemplo de uso

app/page.tsx

🧪 Teste e Implementação

Neumorph Button - Live Preview

Teste todas as variantes e estados do componente

Variantes:

Tamanhos:

Estados:

💡 Dica: Use as abas acima para alternar entre visualização e código. Copie o código e cole diretamente no seu projeto!

🏪 Aplicação prática: Dashboard de Restaurante

Dashboard de Restaurante - Seção de Pedidos

Exemplo real de uso do Neumorph Button em um SaaS de restaurante

🍽️

Pedidos Ativos

Mesa 12, 15, 8

💡 Dica: Use as abas acima para alternar entre visualização e código. Copie o código e cole diretamente no seu projeto!

💡 Dicas de implementação

Performance: Use React.memo() para componentes que re-renderizam frequentemente.

Acessibilidade: O componente já inclui focus states e aria attributes.

Customização: Modifique as variantes e tamanhos conforme seu design system.

Mobile: Use tamanhos 'sm' e 'md' para interfaces mobile.

✅ Primeiro componente implementado!

Parabéns! Você acabou de implementar seu primeiro componente Cult UI e aplicar em um cenário real.

  • • NeumorphButton funcional com todas as variantes
  • • Live preview implementado
  • • Exemplo prático de SaaS de restaurante
  • • Entendimento da filosofia copy-paste