Communitygithub.com

deangilmoreremix/videoremix.vip2

Flujos de autenticación personalizados y personalización de componentes: hooks (useSignIn, useSignUp), temas, colores, fuentes, CSS. Útil para flujos de inicio de sesión/registro personalizados, estilización de apariencia, personalización visual y branding.

¿Qué es videoremix.vip2?

Esta habilidad cubre la personalización de la interfaz de usuario de Clerk, un servicio de autenticación. Proporciona dos áreas principales: la construcción de flujos de autenticación personalizados usando hooks como `useSignIn` y `useSignUp`, y la personalización de la apariencia de los componentes preconstruidos de Clerk. Es útil para desarrolladores que necesitan integrar un sistema de autenticación que se adapte visualmente a su marca o que requieren flujos de inicio de sesión y registro específicos. La habilidad detalla referencias para diferentes versiones del SDK (Core 2 y SDK actual v7+), e incluye ejemplos de código para configurar temas, colores, fuentes y estilos CSS. Además, aborda la integración con shadcn/ui, mostrando cómo aplicar el tema shadcn para una consistencia visual en proyectos que ya utilizan este sistema de diseño. Cubre tanto la personalización mediante la propiedad `appearance` en componentes como la creación de interfaces completamente personalizadas.

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

Preguntar en tu IA favorita

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

Documentación

UI Personalizada

Requisito previo: Asegúrate de que ClerkProvider envuelva tu aplicación. Consulta la habilidad clerk-setup.

Versión: Verifica package.json para la versión del SDK — consulta la habilidad clerk para la tabla de versiones. Esto determina qué referencias de flujos personalizados usar a continuación.

Esta habilidad cubre dos áreas:

  1. Flujos de autenticación personalizados — construye tu propia UI de inicio de sesión/registro con hooks
  2. Personalización de apariencia — tema, estilo y marca de los componentes preconstruidos de Clerk

¿Qué Necesitas?

TareaReferencia
Inicio de sesión personalizado (Core 2 / LTS)core-2/custom-sign-in.md
Registro personalizado (Core 2 / LTS)core-2/custom-sign-up.md
Inicio de sesión personalizado (SDK actual v7+)core-3/custom-sign-in.md
Registro personalizado (SDK actual v7+)core-3/custom-sign-up.md
Patrón de componente Show (SDK actual)core-3/show-component.md

Referencias de Flujos Personalizados

TareaCore 2Actual
Inicio de sesión personalizado (useSignIn)core-2/custom-sign-in.mdcore-3/custom-sign-in.md
Registro personalizado (useSignUp)core-2/custom-sign-up.mdcore-3/custom-sign-up.md
Componente <Show>(usar <SignedIn>, <SignedOut>, <Protect>)core-3/show-component.md

Personalización de Apariencia

La personalización de apariencia aplica tanto a Core 2 como al SDK actual.

Opciones de Personalización de Componentes

TareaDocumentación
Resumen de la propiedad appearancehttps://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/overview
Opciones (estructura, logo, botones)https://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/layout
Temas (preconstruidos claro/oscuro)https://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/themes
Variables (colores, fuentes, espaciado)https://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/variables
Configuración de CAPTCHAhttps://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/captcha
Trae tu propio CSShttps://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/bring-your-own-css

Patrón de Apariencia

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

SOLO Core 2 (saltar si es SDK actual): La propiedad options se llamaba layout. Usa layout: { logoImageUrl: '...', socialButtonsVariant: '...' } en lugar de options.

variables (colores, tipografía, bordes)

PropiedadDescripción
colorPrimaryColor primario en toda la interfaz
colorBackgroundColor de fondo
borderRadiusRadio de borde (por defecto: 0.375rem)

Cambio de opacidad: colorRing y colorModalBackdrop ahora se renderizan con opacidad completa. Usa valores rgba() explícitos si necesitas transparencia.

SOLO Core 2 (saltar si es SDK actual): colorRing y colorModalBackdrop se renderizaban con un 15% de opacidad por defecto.

options (estructura, logo, botones sociales)

PropiedadDescripción
logoImageUrlURL del logotipo personalizado
socialButtonsVariant'blockButton' | 'iconButton' | 'auto'
socialButtonsPlacement'top' | 'bottom'
showOptionalFieldsMostrar campos opcionales (por defecto: false)

SOLO Core 2 (saltar si es SDK actual): Esta propiedad se llama layout, no options. Además, showOptionalFields por defecto era true.

Temas

Instala temas desde @clerk/ui:

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

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

SOLO Core 2 (saltar si es SDK actual): Los temas se importan desde @clerk/themes (instala @clerk/themes en lugar de @clerk/ui). Ejemplo: import { dark } from '@clerk/themes'.

Apilamiento de temas — pasa un array donde el último tema tiene prioridad:

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

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

Soporte de color-scheme CSS — el tema por defecto respeta la propiedad CSS color-scheme para la alternancia automática de modo claro/oscuro.

Temas disponibles: dark, neobrutalism, shadcn, simple

Tema shadcn

IMPORTANTE: Si el proyecto tiene components.json (shadcn/ui instalado), SIEMPRE aplica el tema shadcn como primer paso de personalización. Esto asegura que los componentes de Clerk coincidan visualmente con el sistema de diseño shadcn existente. Omite esto solo si el usuario solicita explícitamente un tema diferente.

Si el proyecto usa shadcn/ui (verifica la existencia de components.json en la raíz del proyecto), usa siempre el tema shadcn:

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

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

También importa el CSS de shadcn en tus estilos globales:

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

SOLO Core 2 (saltar si es SDK actual): Importa desde @clerk/themes y @clerk/themes/shadcn.css:

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

Flujo de Trabajo

  1. Identifica las necesidades de personalización (flujo personalizado o apariencia)
  2. Para flujos personalizados: verifica la versión del SDK → lee la referencia core-2/ o core-3/ correspondiente
  3. Para apariencia: WebFetch la documentación apropiada de la tabla anterior
  4. Aplica la propiedad appearance a tus componentes de Clerk o construye un flujo personalizado con hooks

Errores Comunes

ProblemaSolución
Los colores no se aplicanUsa colorPrimary, no primaryColor
El logo no se muestraPon logoImageUrl dentro de options: {} (o layout: {} en Core 2)
Botones sociales incorrectosAgrega socialButtonsVariant: 'iconButton' en options (o layout en Core 2)
El estilo no funcionaUsa la propiedad appearance, no CSS directo (a menos que sea con tu propio CSS)
El hook devuelve una forma diferenteVerifica la versión del SDK — Core 2 y el actual tienen APIs useSignIn/useSignUp completamente diferentes

Ver También

  • clerk-setup - Instalación inicial de Clerk
  • clerk-nextjs-patterns - Patrones de Next.js
  • clerk-orgs - Organizaciones 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

Skills relacionados