설치
1
패키지 설치하기
@whop/react 패키지에는 Frosted UI와 필요한 모든 의존성이 포함되어 있습니다.2
WhopApp 프로바이더 설정하기
루트 레이아웃에서 애플리케이션을
WhopApp 컴포넌트로 감싸세요. 이렇게 하면 테마와 iframe SDK가 설정됩니다.3
Next.js 구성하기(선택 사항)
Next.js 구성에서
withWhopAppConfig 래퍼를 사용하세요:이렇게 하면 서버 액션이 구성되고 Frosted UI 임포트가 최적화됩니다.
4
Tailwind 설정하기(선택 사항)
Tailwind CSS를 사용한다면 Frosted UI 플러그인을 추가하여 디자인 토큰에 접근하세요:
이제 Frosted UI가 설정되어 사용할 준비가 되었습니다.
타이포그래피
Frosted UI는 두 가지 주요 컴포넌트Heading과 Text로 구성된 종합적인 타이포그래피 시스템을 제공합니다.
글자 크기 단계
두 컴포넌트 모두 10단계 크기 스케일(0-9)을 사용합니다:Text 컴포넌트
size:"0"through"9"(기본값:"3")weight:"light"|"regular"|"medium"|"bold"align:"left"|"center"|"right"color: 모든 강조 색상 또는"gray"highContrast: 접근성을 위해 대비를 높입니다as:"span"|"div"|"p"|"label"
Heading 컴포넌트
size:"0"through"9"(기본값:"6")weight:"light"|"regular"|"medium"|"bold"align:"left"|"center"|"right"as:"h1"|"h2"|"h3"|"h4"|"h5"|"h6"color: 모든 강조 색상 또는"gray"highContrast: 접근성을 위해 대비를 높입니다
기타 타이포그래피 컴포넌트
색상
Frosted UI는 Radix 색상 스케일을 사용하며, 솔리드와 알파 변형을 모두 갖춘 12단계 색상 팔레트를 제공합니다.강조 색상
27가지 강조 색상을 사용할 수 있습니다: 일반 색상:tomato, red, ruby, crimson, pink, plum, purple, violet, iris, indigo, blue, cyan, teal, jade, green, grass, brown, orange
밝은 색상: sky, mint, lime, yellow, amber, lemon, magenta
메탈릭 색상: gold, bronze
회색 색상
색온도가 서로 다른 6가지 회색 스케일:gray- 순수한 중립 회색mauve- 약간 보랏빛을 띰slate- 차가운 푸른빛을 띰sage- 은은한 초록빛을 띰olive- 따뜻한 올리브빛을 띰sand- 따뜻한 모래빛을 띰auto- 강조 색상에 자동으로 맞춤
의미 색상
일반적인 사용 사례를 위해 미리 구성된 색상:- 위험:
red(기본값),tomato,ruby - 경고:
amber(기본값),yellow - 성공:
green(기본값),teal,jade,grass - 정보:
sky(기본값),blue
색상 사용하기
Tailwind 색상 클래스
Tailwind 플러그인을 사용하면 Frosted UI 색상을 직접 사용할 수 있습니다:- 1-3단계: 배경과 은은한 채우기
- 4-6단계: 테두리와 구분선
- 7-9단계: 인터랙티브 요소
- 10-12단계: 텍스트와 고대비 요소
- 투명도를 위해
{color}-a1부터{color}-a12까지 사용하세요
다크 모드
Frosted UI는 시스템 환경설정과 사용자 선택을 존중하는 자동 다크 모드 지원을 포함합니다.작동 방식
세 가지 외관 모드로 다크 모드를 관리하세요:"inherit"(기본값) - 시스템 환경설정을 따름"light"- 라이트 모드를 강제함"dark"- 다크 모드를 강제함
whop-frosted-theme)에 저장하며, 쿠키가 없으면 시스템 환경설정으로 대체합니다.
구성
WhopApp 컴포넌트에서 외관을 구성하세요:
Tailwind 다크 모드 클래스
다크 모드 스타일에는dark: 접두사를 사용하세요:
브레이크포인트
Frosted UI는 5개의 브레이크포인트를 가진 모바일 우선 반응형 시스템을 사용합니다.브레이크포인트 단계
반응형 props
많은 컴포넌트가 객체 구문을 사용한 반응형 값을 지원합니다:Tailwind 반응형 클래스
아이콘
Frosted UI는@frosted-ui/icons 패키지를 통해 아이콘 시스템을 제공합니다.
아이콘 사용하기
자주 쓰는 아이콘
Frosted UI는 다음과 같은 아이콘을 포함하는 Radix Icons를 사용합니다:- 내비게이션:
ChevronRightIcon,ChevronDownIcon,ArrowRightIcon - 액션:
Cross2Icon,CheckIcon,PlusIcon,MinusIcon - UI:
MagnifyingGlassIcon,GearIcon,PersonIcon - 라이브러리에서 더 많은 아이콘을 사용할 수 있습니다.
Tailwind 플러그인
Frosted UI Tailwind 플러그인은 디자인 토큰을 Tailwind 유틸리티로 제공합니다.포함된 항목
타이포그래피:표준 Tailwind와의 주요 차이점
- 글꼴 크기 스케일: xs/sm/base/lg 대신 0-9를 사용합니다
- 줄 높이 스케일: 글꼴 크기 스케일(0-9)과 일치합니다
- 색상 시스템: 알파 변형을 갖춘 12단계 Radix 색상 스케일
- 의미 색상: 위험, 경고, 성공, 정보 색상 내장
- 디자인 토큰: 테마 일관성을 위해 모든 값에 CSS 변수를 사용합니다
자주 쓰는 컴포넌트
Button
size:"1"|"2"|"3"|"4"variant:"solid"|"soft"|"surface"|"ghost"|"classic"color: 모든 강조 색상highContrast: 대비 강화loading: 로딩 스피너를 표시합니다disabled: 상호작용을 비활성화합니다
Input
Card
Badge
Dialog
Select
체크박스와 라디오
고급 사용법
테마 사용자 지정
여러 옵션으로 테마를 사용자 지정하세요:중첩 테마
서로 다른 테마로 섹션을 만드세요:테마 컨텍스트 접근하기
컴포넌트 라이브러리
Frosted UI에는 카테고리별로 정리된 60개 이상의 컴포넌트가 포함되어 있습니다: 레이아웃:Box, Flex, Grid, Container, Section, AspectRatio, Inset
타이포그래피: Heading, Text, Code, Strong, Em, Kbd, Quote, Blockquote
양식: TextInput, TextArea, Checkbox, RadioGroup, Select, Switch, Slider, DatePicker, OTPField
버튼: Button, IconButton
디스플레이: Card, Avatar, AvatarGroup, Badge, Callout, Table, DataList, Skeleton
내비게이션: Tabs, Breadcrumbs, Link, SegmentedControl
오버레이: Dialog, AlertDialog, Drawer, Sheet, Popover, HoverCard, Tooltip, DropdownMenu, ContextMenu
피드백: Progress, CircularProgress, Spinner
유틸리티: ScrollArea, Separator, Portal, VisuallyHidden, AccessibleIcon
모든 컴포넌트는 Radix UI 프리미티브를 기반으로 만들어졌으며 접근성 모범 사례를
따릅니다.
리소스
- Radix UI 문서 - 컴포넌트 프리미티브
- Radix Colors - 색상 시스템 문서
- Tailwind CSS - 유틸리티 우선 CSS 프레임워크

