Communitygithub.com

deangilmoreremix/videoremix.vip2

Fluxos de autenticação personalizados e aparência de componentes — hooks (useSignIn, useSignUp), temas, cores, fontes, CSS. Use para criar fluxos personalizados de login/cadastro, estilização visual e branding.

O que é videoremix.vip2?

Este skill cobre a personalização de autenticação e aparência para aplicações que usam Clerk. Ele permite construir interfaces de login e cadastro feitas sob medida com os hooks useSignIn e useSignUp, além de modificar a aparência dos componentes prontos do Clerk via temas, cores, fontes e CSS próprio. O skill é compatível com diferentes versões do SDK (Core 2 e Core 3/v7+), fornecendo referências específicas para cada uma. Também inclui integração com shadcn/ui, permitindo que os componentes do Clerk se alinhem visualmente com o design system do projeto. É útil para desenvolvedores que precisam de controle total sobre a experiência de autenticação ou desejam adaptar o visual ao branding da aplicação, seja com fluxos totalmente customizados ou apenas ajustes no tema.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/deangilmoreremix/videoremix.vip2/tree/HEAD/.agents/skills/clerk-custom-ui

Perguntar na sua IA favorita

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

Documentação

IU Personalizada

Pré-requisito: Certifique-se de que ClerkProvider envolve seu aplicativo. Veja o skill clerk-setup.

Versão: Verifique o arquivo package.json para a versão do SDK — veja o skill clerk para a tabela de versões. Isso determina quais referências de fluxo personalizado usar abaixo.

Este skill cobre duas áreas:

  1. Fluxos de autenticação personalizados — crie sua própria IU de login/cadastro com hooks
  2. Personalização de aparência — tema, estilo e marca dos componentes prontos do Clerk

Do Que Você Precisa?

TarefaReferência
Login personalizado (Core 2 / LTS)core-2/custom-sign-in.md
Cadastro personalizado (Core 2 / LTS)core-2/custom-sign-up.md
Login personalizado (SDK Atual v7+)core-3/custom-sign-in.md
Cadastro personalizado (SDK Atual v7+)core-3/custom-sign-up.md
Padrão de componente Show (SDK Atual)core-3/show-component.md

Referências de Fluxo Personalizado

TarefaCore 2Atual
Login personalizado (useSignIn)core-2/custom-sign-in.mdcore-3/custom-sign-in.md
Cadastro personalizado (useSignUp)core-2/custom-sign-up.mdcore-3/custom-sign-up.md
Componente <Show>(use <SignedIn>, <SignedOut>, <Protect>)core-3/show-component.md

Personalização de Aparência

A personalização de aparência se aplica tanto ao Core 2 quanto ao SDK atual.

Opções de Personalização de Componentes

TarefaDocumentação
Visão geral da prop appearancehttps://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/overview
Opções (estrutura, logotipo, botões)https://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/layout
Temas (pré-construídos claro/escuro)https://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/themes
Variáveis (cores, fontes, espaçamento)https://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/variables
Configuração de CAPTCHAhttps://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/captcha
Traga seu próprio CSShttps://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/bring-your-own-css

Padrão de Aparência

<SignIn
  appearance={{
    variables: {
      colorPrimary: '#0000ff',
      borderRadius: '0.5rem',
    },
    options: {
      logoImageUrl: '/logo.png',
      socialButtonsVariant: 'iconButton',
    },
  }}
/>

APENAS Core 2 (pule se for SDK atual): A propriedade options era nomeada layout. Use layout: { logoImageUrl: '...', socialButtonsVariant: '...' } em vez de options.

variables (cores, tipografia, bordas)

PropriedadeDescrição
colorPrimaryCor principal em todo o componente
colorBackgroundCor de fundo
borderRadiusRaio da borda (padrão: 0.375rem)

Mudança de opacidade: colorRing e colorModalBackdrop agora renderizam com opacidade total. Use valores rgba() explícitos se precisar de transparência.

APENAS Core 2 (pule se for SDK atual): colorRing e colorModalBackdrop renderizavam com 15% de opacidade por padrão.

options (estrutura, logotipo, botões sociais)

PropriedadeDescrição
logoImageUrlURL para logotipo personalizado
socialButtonsVariant'blockButton' | 'iconButton' | 'auto'
socialButtonsPlacement'top' | 'bottom'
showOptionalFieldsMostrar campos opcionais (padrão: false)

APENAS Core 2 (pule se for SDK atual): Esta propriedade se chama layout, não options. Além disso, showOptionalFields era padronizado como true.

Temas

Instale temas a partir de @clerk/ui:

npm install @clerk/ui
import { dark } from '@clerk/ui/themes'

<ClerkProvider appearance={{ theme: dark }} />

APENAS Core 2 (pule se for SDK atual): Os temas são importados de @clerk/themes (instale @clerk/themes em vez de @clerk/ui). Exemplo: import { dark } from '@clerk/themes'.

Empilhamento de temas — passe um array onde o último tema tem precedência:

import { dark, neobrutalism } from '@clerk/ui/themes'

<ClerkProvider appearance={{ theme: [dark, neobrutalism] }} />

Suporte a CSS color-scheme — o tema padrão respeita a propriedade CSS color-scheme para alternância automática entre modo claro/escuro.

Temas disponíveis: dark, neobrutalism, shadcn, simple

Tema shadcn

IMPORTANTE: Se o projeto tiver components.json (shadcn/ui instalado), SEMPRE aplique o tema shadcn como PRIMEIRA etapa de personalização. Isso garante que os componentes do Clerk correspondam visualmente ao sistema de design shadcn existente. Pule isso apenas se o usuário solicitar explicitamente um tema diferente.

Se o projeto usa shadcn/ui (verifique se existe components.json na raiz do projeto), sempre use o tema shadcn:

import { shadcn } from '@clerk/ui/themes'

<ClerkProvider appearance={{ theme: shadcn }} />

Importe também o CSS shadcn em seus estilos globais:

@import 'tailwindcss';
@import '@clerk/ui/themes/shadcn.css';

APENAS Core 2 (pule se for SDK atual): Importe de @clerk/themes e @clerk/themes/shadcn.css:

import { shadcn } from '@clerk/themes'
@import '@clerk/themes/shadcn.css';

Fluxo de Trabalho

  1. Identifique as necessidades de personalização (fluxo personalizado ou aparência)
  2. Para fluxos personalizados: verifique a versão do SDK → leia a referência apropriada core-2/ ou core-3/
  3. Para aparência: faça WebFetch da documentação apropriada da tabela acima
  4. Aplique a prop appearance aos seus componentes Clerk ou construa um fluxo personalizado com hooks

Problemas Comuns

ProblemaSolução
Cores não estão sendo aplicadasUse colorPrimary, não primaryColor
Logotipo não apareceColoque logoImageUrl dentro de options: {} (ou layout: {} no Core 2)
Botões sociais erradosAdicione socialButtonsVariant: 'iconButton' em options (ou layout no Core 2)
Estilização não funcionaUse a prop appearance, não CSS direto (a menos que use bring-your-own-css)
Hook retorna formato diferenteVerifique a versão do SDK — Core 2 e atual têm APIs useSignIn/useSignUp completamente diferentes

Veja Também

  • clerk-setup — Instalação inicial do Clerk
  • clerk-nextjs-patterns — Padrões Next.js
  • clerk-orgs — Organizações B2B

Individual skills in this repo

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

deangilmoreremix/videoremix.vip2

Implement Clerk authentication for native Android apps using Kotlin and Jetpack Compose with clerk-android source-guided patterns. Use for prebuilt AuthView/UserButton or custom API-driven auth flows. Do not use for Expo or React Native projects.

deangilmoreremix/videoremix.vip2

Astro patterns with Clerk — middleware, SSR pages, island components, API routes, static vs SSR rendering. Triggers on: astro clerk, clerk astro middleware, astro protected page, clerk island component, astro API route auth, clerk astro SSR.

deangilmoreremix/videoremix.vip2

Clerk Backend REST API explorer and executor. Browse tags, inspect endpoint schemas, and execute authenticated requests. Use when listing users, managing organizations, or calling any Clerk API endpoint.

deangilmoreremix/videoremix.vip2

Clerk Billing for subscription management - render Clerk's PricingTable and in-app checkout drawer, configure subscription plans, seat-limit plans for B2B, feature entitlements with has(), and billing webhooks. Use for SaaS monetization, plan gating, checkout flows, trials, invoicing, and subscription lifecycle management.

deangilmoreremix/videoremix.vip2

Chrome Extension auth with @clerk/chrome-extension -- popup/sidepanel setup, syncHost for OAuth/SAML via web app, createClerkClient for service workers and headless extensions, stable CRX ID. Triggers on: Chrome extension auth, Plasmo clerk, popup sign-in, syncHost, background service worker token, createClerkClient, headless extension.

deangilmoreremix/videoremix.vip2

>- Operate the Clerk CLI (`clerk` binary) for authentication, user/org/session management, deploy verification, instance config, env keys, and any Clerk Backend or Platform API call. Use when the user mentions Clerk management tasks, "list clerk users", "create a clerk user", "update organization", "pull clerk config", "clerk env pull", "clerk doctor", "clerk deploy", "clerk deploy status", "clerk api", or any ad-hoc Clerk API request. Prefer the CLI over raw HTTP: it handles auth, key resolution, app/instance targeting, and formatting automatically.

deangilmoreremix/videoremix.vip2

Agent skill / project related to launch or product demo video: deangilmoreremix/videoremix.vip2

Habilidades Relacionadas