Communitygithub.com

deangilmoreremix/videoremix.vip2

Benutzerdefinierte Authentifizierungsabläufe und Komponentendarstellung – Hooks (useSignIn, useSignUp), Themes, Farben, Schriften, CSS. Verwenden Sie benutzerdefinierte Anmelde-/Registrierungsabläufe, Anpassung des Erscheinungsbilds, visuelle Anpassung und Branding.

Was ist videoremix.vip2?

Diese Skill-Anleitung behandelt die Anpassung von Clerk-Komponenten in zwei Bereichen: benutzerdefinierte Authentifizierungsabläufe (eigene Anmelde-/Registrierungsseiten mittels Hooks) und die visuelle Anpassung vorgefertigter Komponenten (Themes, Farben, Schriften, Logos). Die Anleitung erklärt, wie man für ein aktuelles SDK (v7+) oder Core 2 die richtigen Referenzen findet, und zeigt detailliert die Optionen des `appearance`-Props, die Verwendung von Themes und die Integration mit shadcn/ui. Sie hilft Entwicklern, Clerk nahtlos in ihr Branding einzufügen oder vollständig eigene UI-Abläufe zu implementieren. Die Plattformunterstützung umfasst Next.js und andere Clerk-kompatible Frameworks.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Benutzerdefinierte Benutzeroberfläche

Voraussetzung: Stellen Sie sicher, dass ClerkProvider Ihre App umschließt. Siehe Skill clerk-setup.

Version: Überprüfen Sie package.json auf die SDK-Version – siehe Skill clerk für die Versionstabelle. Diese bestimmt, welche Referenzen für benutzerdefinierte Abläufe unten verwendet werden.

Dieser Skill deckt zwei Bereiche ab:

  1. Benutzerdefinierte Authentifizierungsabläufe – erstellen Sie Ihre eigene Anmelde-/Registrierungsseite mit Hooks
  2. Anpassung des Erscheinungsbilds – Thema, Stil und Branding von Clerks vorgefertigten Komponenten

Was brauchen Sie?

AufgabeReferenz
Benutzerdefinierte Anmeldung (Core 2 / LTS)core-2/custom-sign-in.md
Benutzerdefinierte Registrierung (Core 2 / LTS)core-2/custom-sign-up.md
Benutzerdefinierte Anmeldung (aktuelles SDK v7+)core-3/custom-sign-in.md
Benutzerdefinierte Registrierung (aktuelles SDK v7+)core-3/custom-sign-up.md
Komponentenmuster anzeigen (aktuelles SDK)core-3/show-component.md

Referenzen für benutzerdefinierte Abläufe

AufgabeCore 2Aktuell
Benutzerdefinierte Anmeldung (useSignIn)core-2/custom-sign-in.mdcore-3/custom-sign-in.md
Benutzerdefinierte Registrierung (useSignUp)core-2/custom-sign-up.mdcore-3/custom-sign-up.md
<Show>-Komponente(verwenden Sie <SignedIn>, <SignedOut>, <Protect>)core-3/show-component.md

Anpassung des Erscheinungsbilds

Die Anpassung des Erscheinungsbilds gilt sowohl für Core 2 als auch für das aktuelle SDK.

Optionen zur Komponentenanpassung

AufgabeDokumentation
Übersicht über das appearance-Prophttps://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/overview
Optionen (Struktur, Logo, Schaltflächen)https://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/layout
Themes (vorgefertigt dunkel/hell)https://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/themes
Variablen (Farben, Schriften, Abstände)https://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/variables
CAPTCHA-Konfigurationhttps://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/captcha
Eigenes CSS einbringenhttps://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/bring-your-own-css

Muster für das Erscheinungsbild

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

NUR Core 2 (überspringen, wenn aktuelles SDK): Die options-Eigenschaft hieß layout. Verwenden Sie stattdessen layout: { logoImageUrl: '...', socialButtonsVariant: '...' } anstelle von options.

variables (Farben, Typografie, Rahmen)

EigenschaftBeschreibung
colorPrimaryPrimärfarbe im gesamten Erscheinungsbild
colorBackgroundHintergrundfarbe
borderRadiusRahmenradius (Standard: 0.375rem)

Änderung der Deckkraft: colorRing und colorModalBackdrop werden jetzt mit voller Deckkraft dargestellt. Verwenden Sie explizite rgba()-Werte, wenn Sie Transparenz benötigen.

NUR Core 2 (überspringen, wenn aktuelles SDK): colorRing und colorModalBackdrop wurden standardmäßig mit 15% Deckkraft dargestellt.

options (Struktur, Logo, Social-Buttons)

EigenschaftBeschreibung
logoImageUrlURL zum benutzerdefinierten Logo
socialButtonsVariant'blockButton' | 'iconButton' | 'auto'
socialButtonsPlacement'top' | 'bottom'
showOptionalFieldsOptionale Felder anzeigen (Standard: false)

NUR Core 2 (überspringen, wenn aktuelles SDK): Diese Eigenschaft heißt layout, nicht options. Außerdem war showOptionalFields standardmäßig true.

Themes

Installieren Sie Themes aus @clerk/ui:

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

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

NUR Core 2 (überspringen, wenn aktuelles SDK): Themes werden aus @clerk/themes importiert (installieren Sie @clerk/themes anstelle von @clerk/ui). Beispiel: import { dark } from '@clerk/themes'.

Theme-Stacking – übergeben Sie ein Array, bei dem das letzte Theme Vorrang hat:

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

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

CSS color-scheme-Unterstützung – das Standard-Theme respektiert die CSS-Eigenschaft color-scheme für automatischen hellen/dunklen Modus.

Verfügbare Themes: dark, neobrutalism, shadcn, simple

shadcn-Theme

WICHTIG: Wenn das Projekt components.json enthält (shadcn/ui installiert), wenden Sie IMMER das shadcn-Theme als ersten Anpassungsschritt an. Dadurch wird sichergestellt, dass Clerk-Komponenten visuell mit dem vorhandenen shadcn-Designsystem übereinstimmen. Überspringen Sie dies nur, wenn der Benutzer ausdrücklich ein anderes Theme anfordert.

Wenn das Projekt shadcn/ui verwendet (überprüfen Sie, ob components.json im Projektstamm vorhanden ist), verwenden Sie immer das shadcn-Theme:

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

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

Importieren Sie auch das shadcn-CSS in Ihre globalen Styles:

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

NUR Core 2 (überspringen, wenn aktuelles SDK): Importieren Sie aus @clerk/themes und @clerk/themes/shadcn.css:

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

Arbeitsablauf

  1. Anpassungsbedarf identifizieren (benutzerdefinierter Ablauf oder Erscheinungsbild)
  2. Für benutzerdefinierte Abläufe: SDK-Version prüfen → entsprechende Referenz unter core-2/ oder core-3/ lesen
  3. Für das Erscheinungsbild: Die entsprechende Dokumentation aus der obigen Tabelle per WebFetch abrufen
  4. Das appearance-Prop auf Ihre Clerk-Komponenten anwenden oder einen benutzerdefinierten Ablauf mit Hooks erstellen

Häufige Fallstricke

ProblemLösung
Farben werden nicht angewendetVerwenden Sie colorPrimary, nicht primaryColor
Logo wird nicht angezeigtSetzen Sie logoImageUrl innerhalb von options:{} (oder layout:{} in Core 2)
Social-Buttons falschFügen Sie socialButtonsVariant: 'iconButton' in options (oder layout in Core 2) hinzu
Styling funktioniert nichtVerwenden Sie das appearance-Prop, kein direktes CSS (es sei denn mit "bring your own CSS")
Hook gibt andere Struktur zurückSDK-Version prüfen – Core 2 und aktuelles SDK haben völlig unterschiedliche useSignIn/useSignUp-APIs

Siehe auch

  • clerk-setup - Ersteinrichtung von Clerk
  • clerk-nextjs-patterns - Next.js-Muster
  • clerk-orgs - B2B-Organisationen

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

Verwandte Skills