Communitygithub.com

deangilmoreremix/videoremix.vip2

自定义认证流程和组件外观 —— 钩子(useSignIn、useSignUp)、主题、颜色、字体、CSS。适用于自定义登录/注册流程、外观样式、视觉定制和品牌化。

videoremix.vip2 是什么?

该技能涵盖两个主要领域:自定义认证流程和外观定制。对于自定义认证流程,它提供基于 `useSignIn` 和 `useSignUp` 钩子构建专属登录/注册 UI 的方法,并区分 Core 2(LTS)和当前 SDK(v7+)的不同 API 接口。在外观方面,它详细说明如何通过 `appearance` 属性配置主题(如暗色、shadcn 等)、颜色变量、字体、边距、Logo、社交按钮布局以及 CAPTCHA 等,并支持 CSS 覆盖。技能还特别强调了不同 SDK 版本间的关键差异,例如 Core 2 中的 `layout` 与当前 SDK 中的 `options` 属性名称变化。此技能适用于 Next.js 项目,尤其是集成了 Clerk 认证服务的场景,帮助开发者实现品牌统一化的用户界面。支持平台包括 Clerk 认证库的所有 Web 应用。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

自定义 UI

前置条件:确保 ClerkProvider 已包裹你的应用。参见 clerk-setup 技能。

版本:检查 package.json 中的 SDK 版本 —— 参见 clerk 技能的版本表。这将决定下方使用的自定义流程参考文件。

本技能涵盖两方面内容:

  1. 自定义认证流程 —— 使用钩子构建你自己的登录/注册 UI
  2. 外观定制 —— 主题化、样式化和品牌化 Clerk 的预构建组件

你需要什么?

任务参考文件
自定义登录(Core 2 / LTS)core-2/custom-sign-in.md
自定义注册(Core 2 / LTS)core-2/custom-sign-up.md
自定义登录(当前 SDK v7+)core-3/custom-sign-in.md
自定义注册(当前 SDK v7+)core-3/custom-sign-up.md
显示组件模式(当前 SDK)core-3/show-component.md

自定义流程参考文件

任务Core 2当前版本
自定义登录(useSignIn)core-2/custom-sign-in.mdcore-3/custom-sign-in.md
自定义注册(useSignUp)core-2/custom-sign-up.mdcore-3/custom-sign-up.md
<Show> 组件(使用 <SignedIn>、<SignedOut>、<Protect>)core-3/show-component.md

外观定制

外观定制同时适用于 Core 2 和当前 SDK。

组件定制选项

任务文档
外观属性概览https://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/overview
选项(结构、Logo、按钮)https://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/layout
主题(预构建暗色/亮色)https://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/themes
变量(颜色、字体、间距)https://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/variables
CAPTCHA 配置https://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/captcha
自带 CSShttps://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/bring-your-own-css

外观模式

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

仅限 Core 2(当前 SDK 请跳过): options 属性名为 layout。应使用 layout: { logoImageUrl: '...', socialButtonsVariant: '...' } 替代 options。

变量(颜色、排版、边框)

属性描述
colorPrimary全局主色
colorBackground背景颜色
borderRadius边框圆角(默认:0.375rem)

透明度变化: colorRing 和 colorModalBackdrop 现在以全不透明度渲染。如果需要透明度,请使用显式 rgba() 值。

仅限 Core 2(当前 SDK 请跳过): colorRing 和 colorModalBackdrop 默认以 15% 不透明度渲染。

选项(结构、Logo、社交按钮)

属性描述
logoImageUrl自定义 Logo 的 URL
socialButtonsVariant'blockButton' | 'iconButton' | 'auto'
socialButtonsPlacement'top' | 'bottom'
showOptionalFields显示可选字段(默认:false)

仅限 Core 2(当前 SDK 请跳过): 此属性名为 layout,而非 options。另外,showOptionalFields 默认值为 true。

主题

从 @clerk/ui 安装主题:

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

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

仅限 Core 2(当前 SDK 请跳过): 主题从 @clerk/themes 导入(安装 @clerk/themes 而非 @clerk/ui)。示例:import { dark } from '@clerk/themes'。

主题叠加 —— 传递一个数组,最后一个主题优先级最高:

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

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

CSS color-scheme 支持 —— 默认主题尊重 CSS color-scheme 属性,以实现自动切换亮色/暗色模式。

可用主题: dark、neobrutalism、shadcn、simple

shadcn 主题

重要: 如果项目中有 components.json(已安装 shadcn/ui),始终将 shadcn 主题作为第一个定制步骤应用。这可以确保 Clerk 组件与现有的 shadcn 设计系统在视觉上匹配。仅在用户明确要求其他主题时跳过。

如果项目使用了 shadcn/ui(检查项目根目录下是否有 components.json),始终使用 shadcn 主题:

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

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

同时,在全局样式中导入 shadcn CSS:

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

仅限 Core 2(当前 SDK 请跳过): 从 @clerk/themes 和 @clerk/themes/shadcn.css 导入:

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

工作流程

  1. 确定定制需求(自定义流程或外观)
  2. 对于自定义流程:检查 SDK 版本 → 阅读对应的 core-2/ 或 core-3/ 参考文件
  3. 对于外观:通过网络获取上表中相应的文档
  4. 将外观属性应用于你的 Clerk 组件,或使用钩子构建自定义流程

常见陷阱

问题解决方案
颜色未生效使用 colorPrimary 而非 primaryColor
Logo 未显示将 logoImageUrl 放在 options: {}(或 Core 2 中的 layout: {})内
社交按钮显示异常在 options(或 Core 2 中的 layout)中添加 socialButtonsVariant: 'iconButton'
样式未生效使用 appearance 属性,而非直接 CSS(除非使用自带 CSS)
钩子返回值结构不同检查 SDK 版本 —— Core 2 和当前版本的 useSignIn/useSignUp API 完全不同

参见

  • clerk-setup - 初始 Clerk 安装
  • clerk-nextjs-patterns - Next.js 模式
  • clerk-orgs - 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

相关技能