Communitygithub.com

deangilmoreremix/videoremix.vip2

Flux d'authentification personnalisés et personnalisation de l'apparence des composants – hooks (useSignIn, useSignUp), thèmes, couleurs, polices, CSS. Utilisez-le pour des écrans de connexion/inscription sur mesure, le style visuel et l'image de marque.

Qu'est-ce que videoremix.vip2 ?

Cette compétence vous guide dans la personnalisation de l'authentification et de l'apparence des composants Clerk. Elle couvre deux domaines principaux : la création de flux de connexion/inscription personnalisés via les hooks `useSignIn` et `useSignUp`, et la personnalisation visuelle des composants préconstruits de Clerk (thèmes, couleurs, polices, CSS). Elle prend en charge à la fois Core 2 (SDK plus ancien) et le SDK actuel v7+, avec des références distinctes pour chaque version. La documentation inclut des explications détaillées sur les propriétés d'apparence (`appearance`), les variables de thème (`colorPrimary`, `borderRadius`, etc.), les options de logo et de boutons sociaux, ainsi que des astuces pour appliquer le thème shadcn lorsque le projet utilise shadcn/ui. Elle met en garde contre les pièges courants comme les noms de propriétés incorrects ou les différences d'API entre les versions du SDK.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Interface Utilisateur Personnalisée

Prérequis : Assurez-vous que ClerkProvider enveloppe votre application. Voir la compétence clerk-setup.

Version : Vérifiez package.json pour la version du SDK — voir la compétence clerk pour le tableau des versions. Cela détermine les références de flux personnalisé à utiliser ci-dessous.

Cette compétence couvre deux domaines :

  1. Flux d'authentification personnalisés — construisez votre propre interface de connexion/inscription avec des hooks
  2. Personnalisation de l'apparence — thème, style et marque des composants préconstruits de Clerk

De quoi avez-vous besoin ?

TâcheRéférence
Connexion personnalisée (Core 2 / LTS)core-2/custom-sign-in.md
Inscription personnalisée (Core 2 / LTS)core-2/custom-sign-up.md
Connexion personnalisée (SDK actuel v7+)core-3/custom-sign-in.md
Inscription personnalisée (SDK actuel v7+)core-3/custom-sign-up.md
Modèle d'affichage des composants (SDK actuel)core-3/show-component.md

Références des flux personnalisés

TâcheCore 2Actuel
Connexion personnalisée (useSignIn)core-2/custom-sign-in.mdcore-3/custom-sign-in.md
Inscription personnalisée (useSignUp)core-2/custom-sign-up.mdcore-3/custom-sign-up.md
Composant <Show>(utilisez <SignedIn>, <SignedOut>, <Protect>)core-3/show-component.md

Personnalisation de l'apparence

La personnalisation de l'apparence s'applique à la fois à Core 2 et au SDK actuel.

Options de personnalisation des composants

TâcheDocumentation
Aperçu de la propriété appearancehttps://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/overview
Options (structure, logo, boutons)https://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/layout
Thèmes (clair/sombre pré-construits)https://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/themes
Variables (couleurs, polices, espacement)https://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/variables
Configuration CAPTCHAhttps://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/captcha
Apportez votre propre CSShttps://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/bring-your-own-css

Modèle d'apparence

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

Core 2 UNIQUEMENT (ignorez si SDK actuel) : La propriété options s'appelait layout. Utilisez layout: { logoImageUrl: '...', socialButtonsVariant: '...' } à la place de options.

variables (couleurs, typographie, bordures)

PropriétéDescription
colorPrimaryCouleur primaire générale
colorBackgroundCouleur d'arrière-plan
borderRadiusRayon de bordure (par défaut : 0.375rem)

Changement d'opacité : colorRing et colorModalBackdrop s'affichent désormais en pleine opacité. Utilisez des valeurs rgba() explicites si vous avez besoin de transparence.

Core 2 UNIQUEMENT (ignorez si SDK actuel) : colorRing et colorModalBackdrop s'affichaient avec une opacité de 15% par défaut.

options (structure, logo, boutons sociaux)

PropriétéDescription
logoImageUrlURL du logo personnalisé
socialButtonsVariant'blockButton' | 'iconButton' | 'auto'
socialButtonsPlacement'top' | 'bottom'
showOptionalFieldsAfficher les champs facultatifs (par défaut : false)

Core 2 UNIQUEMENT (ignorez si SDK actuel) : Cette propriété s'appelle layout, pas options. De plus, showOptionalFields était par défaut true.

Thèmes

Installez les thèmes depuis @clerk/ui :

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

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

Core 2 UNIQUEMENT (ignorez si SDK actuel) : Les thèmes sont importés depuis @clerk/themes (installez @clerk/themes au lieu de @clerk/ui). Exemple : import { dark } from '@clerk/themes'.

Empilement de thèmes — passez un tableau où le dernier thème a la priorité :

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

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

Support de color-scheme CSS — le thème par défaut respecte la propriété CSS color-scheme pour le basculement automatique entre mode clair et sombre.

Thèmes disponibles : dark, neobrutalism, shadcn, simple

Thème shadcn

IMPORTANT : Si le projet contient components.json (shadcn/ui installé), appliquez TOUJOURS le thème shadcn comme première étape de personnalisation. Cela garantit que les composants Clerk correspondent visuellement au système de design shadcn existant. Ignorez cette étape uniquement si l'utilisateur demande explicitement un autre thème.

Si le projet utilise shadcn/ui (vérifiez la présence de components.json à la racine du projet), utilisez toujours le thème shadcn :

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

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

Importez également le CSS shadcn dans vos styles globaux :

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

Core 2 UNIQUEMENT (ignorez si SDK actuel) : Importez depuis @clerk/themes et @clerk/themes/shadcn.css :

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

Workflow

  1. Identifiez les besoins de personnalisation (flux personnalisé ou apparence)
  2. Pour les flux personnalisés : vérifiez la version du SDK → lisez la référence appropriée core-2/ ou core-3/
  3. Pour l'apparence : récupérez la documentation appropriée via WebFetch depuis le tableau ci-dessus
  4. Appliquez la propriété appearance à vos composants Clerk ou construisez un flux personnalisé avec des hooks

Pièges courants

ProblèmeSolution
Les couleurs ne s'appliquent pasUtilisez colorPrimary et non primaryColor
Le logo ne s'affiche pasMettez logoImageUrl dans options: {} (ou layout: {} dans Core 2)
Boutons sociaux incorrectsAjoutez socialButtonsVariant: 'iconButton' dans options (ou layout dans Core 2)
Le style ne fonctionne pasUtilisez la propriété appearance, pas du CSS direct (sauf avec bring-your-own-css)
Le hook renvoie une forme différenteVérifiez la version du SDK — Core 2 et l'actuel ont des API useSignIn/useSignUp complètement différentes

Voir aussi

  • clerk-setup - Installation initiale de Clerk
  • clerk-nextjs-patterns - Modèles Next.js
  • clerk-orgs - Organisations 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 associés