Communitygithub.com

deangilmoreremix/videoremix.vip2

사용자 정의 인증 흐름 및 컴포넌트 모양 - 훅(useSignIn, useSignUp), 테마, 색상, 글꼴, CSS. 맞춤형 로그인/회원가입 흐름, 모양 스타일링, 시각적 커스터마이징, 브랜딩에 사용됩니다.

videoremix.vip2란 무엇인가요?

이 스킬은 Clerk의 사전 구축된 인증 구성 요소를 사용자 정의하는 두 가지 주요 영역을 다룹니다: 사용자 정의 인증 흐름과 외형 커스터마이징입니다. 사용자 정의 흐름을 위해 `useSignIn` 및 `useSignUp`과 같은 훅을 사용하여 처음부터 고유한 로그인/회원가입 UI를 구축하는 방법을 설명하며, Core 2(LTS)와 현재 SDK(v7+) 버전을 모두 지원합니다. 외형 측면에서는 `appearance` prop을 통해 테마(dark, neobrutalism, shadcn, simple), 색상 변수, 글꼴, 로고, 소셜 버튼 스타일 등을 구성하는 방법을 제공하며, shadcn/ui 기반 프로젝트의 경우 자동으로 shadcn 테마를 우선 적용해야 합니다. 또한 CSS `color-scheme` 속성을 통한 자동 라이트/다크 모드 전환을 지원하고, Core 2와 현재 SDK 간의 주요 차이점(예: `options` vs `layout` prop, 테마 임포트 경로)을 강조하여 개발자가 실수 없이 설정할 수 있도록 돕습니다. 이 스킬은 `clerk-setup` 스킬이 선행되어야 하며, Next.js 패턴 및 조직(B2B) 관리를 위한 추가 스킬과 함께 사용됩니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

사용자 정의 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 모두에 적용됩니다.

컴포넌트 커스터마이징 옵션

작업문서
appearance prop 개요https://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/overview
옵션 (구조, 로고, 버튼)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
자체 CSS 사용https://clerk.com/docs/nextjs/guides/customizing-clerk/appearance-prop/bring-your-own-css

Appearance 패턴

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

Core 2 전용 (현재 SDK인 경우 건너뛰기): options 속성은 layout으로 명명되었습니다. options 대신 layout: { logoImageUrl: '...', socialButtonsVariant: '...' }를 사용하세요.

variables (색상, 타이포그래피, 테두리)

속성설명
colorPrimary전체 기본 색상
colorBackground배경 색상
borderRadius테두리 반경 (기본값: 0.375rem)

불투명도 변경: colorRing 및 colorModalBackdrop은 이제 전체 불투명도로 렌더링됩니다. 투명도가 필요한 경우 명시적인 rgba() 값을 사용하세요.

Core 2 전용 (현재 SDK인 경우 건너뛰기): colorRing 및 colorModalBackdrop은 기본적으로 15% 불투명도로 렌더링되었습니다.

options (구조, 로고, 소셜 버튼)

속성설명
logoImageUrl사용자 정의 로고 URL
socialButtonsVariant'blockButton' | 'iconButton' | 'auto'
socialButtonsPlacement'top' | 'bottom'
showOptionalFields선택적 필드 표시 (기본값: false)

Core 2 전용 (현재 SDK인 경우 건너뛰기): 이 속성은 options가 아닌 layout이라고 합니다. 또한 showOptionalFields는 기본값이 true였습니다.

테마

@clerk/ui에서 테마 설치:

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

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

Core 2 전용 (현재 SDK인 경우 건너뛰기): 테마는 @clerk/themes에서 가져옵니다(@clerk/ui 대신 @clerk/themes 설치). 예: 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 구성 요소에 appearance prop 적용 또는 훅으로 사용자 정의 흐름 구축

일반적인 문제

문제해결 방법
색상이 적용되지 않음primaryColor가 아닌 colorPrimary 사용
로고가 표시되지 않음options: {}(또는 Core 2에서는 layout: {}) 안에 logoImageUrl 넣기
소셜 버튼이 잘못됨options(또는 Core 2에서는 layout)에 socialButtonsVariant: 'iconButton' 추가
스타일링이 작동하지 않음직접 CSS 대신 appearance prop 사용 (bring-your-own-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

관련 스킬