Creative Tim UI
Uma biblioteca abrangente de blocos construída sobre o shadcn/ui, com mais de 390 blocos prontos para produção em mais de 40 categorias. Todos os blocos são React + Tailwind CSS, compatíveis com Next.js (App Router), Remix e Vite.
Navegue pela biblioteca completa: https://www.creative-tim.com/ui Índice legível por IA: https://www.creative-tim.com/ui/llms.txt
Instalar Esta Skill
# Instalar via CLI de skills (recomendado)
npx skills add creativetimofficial/ui
# Instalar globalmente (disponível em todos os projetos)
npx skills add creativetimofficial/ui -g
# Ou instalar apenas para um agente específico
npx skills add creativetimofficial/ui --agent claude-code
Página da skill: https://skills.sh/creativetimofficial/ui/creative-tim-ui
Filosofia de Design
Ao longo de mais de 300 produtos e categorias, a Creative Tim aplicou a mesma disciplina: identificar o que os desenvolvedores realmente precisam, construir isso excepcionalmente bem e cortar todo o resto. Essa contenção é o núcleo da biblioteca.
Ao gerar ou modificar blocos, siga estes princípios:
A Regra dos 95% — construa o caso comum excepcionalmente bem. Não adicione configuração, abstração ou flexibilidade para problemas que raramente existem. Um desenvolvedor deve ser capaz de ler um bloco e entender imediatamente o que ele faz.
O Princípio "Leve" — um bloco está pronto quando não há mais nada a remover, não quando não há mais nada a adicionar. Questione cada div wrapper, cada prop, cada animação, cada ícone. Se o bloco funciona sem, provavelmente deveria ficar sem.
Pesquise antes de renderizar — pergunte o que a pessoa olhando para esta tela está tentando fazer. Um painel destaca o número que alguém precisa para agir. Um formulário coleta informações com a menor resistência possível. Projete para o propósito, não para a superfície.
Construa sobre fundamentos — primitivas do shadcn/ui (Card, Table, Button, Badge) são bem projetadas e mantidas. Componha-as; não as reimplemente. A contribuição da Creative Tim está na composição e no julgamento, não nas primitivas.
Uso real, não uso de demonstração — o padrão é: uma equipe real enviaria isso em uma aplicação de produção? Evite complexidade visual que não carrega informação. Comunicação supera decoração sempre.
Detalhes completos com exemplos de código: rules/brand-philosophy.md
Quando Aplicar
Use esta skill quando:
- Instalar ou personalizar um bloco UI da Creative Tim em um projeto
- Gerar novos blocos que devem corresponder ao sistema de design da Creative Tim
- Revisar código UI gerado para conformidade com a marca/estilo
- Configurar acesso à chave de API PRO para blocos premium
- Integrar um novo projeto para usar a biblioteca UI da Creative Tim
Categorias de Blocos
| Categoria | Slug | Descrição |
|---|---|---|
| Agentes de IA | ai-agents | Interfaces de chat, feeds de atividade, uso de ferramentas, transcrição |
| Páginas | pages | Layouts completos de gerenciamento de agentes |
| Conta | account | Perfil, configurações, gerenciamento de faturamento |
| Autenticação | authentication | Fluxos de login, registro, 2FA |
| Hero | hero | Seções de hero para landing pages |
| Preços | pricing | Tabelas de preços e planos de faturamento |
| Gráficos | charts | Visualização de dados |
| KPI | kpi | Cartões de métricas e painéis |
| Estatísticas | stats | Seções de estatísticas |
| Tabelas | table | Tabelas de dados com ordenação/filtragem |
| E-commerce | ecommerce | Listagens de produtos, carrinhos, checkout |
| Blog | blog | Listas de artigos, layouts de postagens |
| Depoimentos | testimonials | Seções de prova social |
| ... | [Lista completa em /ui/llms.txt] |
Instalação de Blocos
Dois métodos são totalmente suportados — escolha o que se adequa à sua configuração.
Opção 1 — CLI da Creative Tim (recomendada)
npx @creative-tim/ui@latest add <nome-do-bloco>
Inicialize um novo projeto primeiro (detecta automaticamente Next.js / Vite / Remix / Astro):
npx @creative-tim/ui@latest init
Exemplos:
npx @creative-tim/ui@latest add hero-01
npx @creative-tim/ui@latest add ai-agent-activity-01
npx @creative-tim/ui@latest add agent-management-list-01
O pacote também inclui binários nomeados (creative-tim-ui, creative-tim) — mesmos comandos:
npx creative-tim-ui add hero-01
npx creative-tim add hero-01
Opção 2 — CLI shadcn (URL completa)
npx shadcn@latest add https://www.creative-tim.com/ui/r/<nome-do-bloco>.json
Exemplo:
npx shadcn@latest add https://www.creative-tim.com/ui/r/hero-01.json
npx shadcn@latest add https://www.creative-tim.com/ui/r/ai-agent-activity-01.json
Ambos os métodos copiam o código-fonte do componente para o seu projeto e instalam automaticamente todas as primitivas necessárias do shadcn/ui (Button, Card, Badge, etc.).
Blocos PRO (Chave de API)
Alguns blocos são marcados como PRO e requerem uma chave de API da Creative Tim. Você pode obter uma chave gratuita em https://www.creative-tim.com/ui.
Configuração
Adicione a chave ao seu ambiente:
# .env.local
CREATIVE_TIM_UI_API_KEY=pk_live_xxxxxxxxxxxxxxxx
Passe a chave ao usar qualquer CLI:
# CLI da Creative Tim
npx @creative-tim/ui@latest add nome-do-bloco-pro --api-key $CREATIVE_TIM_UI_API_KEY
# CLI shadcn — defina o cabeçalho Authorization via configuração do registro
Ou defina-a globalmente via configuração da CLI da Creative Tim:
npx @creative-tim/ui@latest login --api-key pk_live_xxxxxxxxxxxxxxxx
Depois de definir a chave, os blocos PRO são instalados de forma idêntica aos blocos gratuitos.
Regras de Design
Consulte os arquivos de regras individuais para detalhes completos. Resumo rápido:
Cores da Marca
- Tom principal: laranja (
orange-500/orange-600) — cor da marca Creative Tim - Nunca use
violet,purpleouindigocomo cores de destaque — isso sinaliza padrões gerados por IA - Superfícies neutras:
slate,gray,zinc - Status:
emerald(sucesso),amber(aviso),red(erro),blue(informação)
Tipografia
text-smpara todo conteúdo de corpo legível — rótulos, descrições, células de tabela, itens de listatext-xsapenas para: iniciais de avatar, timestampsfont-mono, badges (status/prioridade), cabeçalhos de grupo da barra lateral (maiúsculas + tracking-wider), botões de ação pequenos (h-6/h-7)- Nunca use
text-[10px],text-[11px]ou qualquer valor arbitrário de fonte
Tailwind v4 — Sem Valores Arbitrários
- Use a escala numérica para espaçamento/tamanho:
h-8,w-12,gap-3,p-4— nuncah-[32px] - Use frações padrão para larguras:
max-w-sm,max-w-2xl,w-1/2— nuncamax-w-[85%] - Apenas breakpoints responsivos:
sm:,md:,lg:,xl:— nunca[@media(min-width:640px)]:
Padrões de Componentes
- Prefira
Card > CardHeader + CardContentpara agrupar conteúdo - Cartões de KPI / estatísticas:
CardContent className="px-4 py-0"(py-0, não py-6 padrão) - Use
ScrollAreapara qualquer lista que possa transbordar - Navegação da barra lateral: 64 (
w-64), border-r,bg-muted/30 - Evite
style={}inline — sempre use classes Tailwind
Segurança de Hidratação
- Nunca use
new Date(),Date.now()outoLocaleTimeString()em inicializadores deuseState - Use strings estáticas/hardcoded para estado inicial seguro para SSR; mude para valores dinâmicos dentro de
useEffect/setInterval
Guia Completo de Design
Para as regras completas com exemplos de código: AGENTS.md
Regras individuais:
rules/install-blocks.md — Guia de instalação via CLI
rules/pro-api-key.md — Configuração e autenticação de chave PRO
rules/design-brand.md — Cores e identidade da marca
rules/tailwind-rules.md — Restrições de codificação Tailwind v4
rules/component-patterns.md — Padrões de componentes preferidos
rules/hydration-safety.md — Regras de hidratação SSR/CSR
Implantação Desta Skill
Esta skill reside no repositório em .claude/skills/creative-tim-ui/. Qualquer pessoa pode instalá-la em sua própria configuração do Claude Code executando:
claude skill install github.com/creativetimofficial/ui .claude/skills/creative-tim-ui
Ou clonando e vinculando manualmente:
# Clone ou copie o diretório de skills para o seu projeto
cp -r path/to/ui-repo/.claude/skills/creative-tim-ui .claude/skills/creative-tim-ui
Uma vez instalada, a skill está disponível como /creative-tim-ui em qualquer sessão do Claude Code dentro desse projeto.