8000 GitHub - Jihye2ee/jamie-ui · GitHub
[go: up one dir, main page]

Skip to content
Jihye2eePublic

About

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

jamie-ui

jamie-ui components

디자인 시스템 기반 UI 컴포넌트 라이브러리 + AI Playground입니다.

Playground에서 만들고 싶은 화면을 자연어로 설명하면, 디자인 시스템에 맞는 컴포넌트 조합을 즉시 생성합니다. 결과를 복사해서 프로젝트에 바로 사용하세요.

사용법

  1. Playground에서 만들고 싶은 UI를 자연어로 설명
  2. AI가 jamie-ui 컴포넌트로 조합된 결과를 생성
  3. 생성된 코드를 복사 → 내 프로젝트에 붙여넣기
  4. 필요에 맞게 수정

개별 컴포넌트의 props나 variant를 확인하려면 문서 사이트를 참고하세요.

누가, 언제 쓰는가

디자이너 — Figma 작업 전/중, 검증 도구로 활용

"우리 컴포넌트로 이 화면이 가능한가?"를 확인할 수 있습니다. 디자인 시스템에 정의된 컴포넌트가 실제 코드에 어떻게 반영되어 있는지, 제약사항이 무엇인지 Playground에서 빠르게 시험하면 Figma 작업 전에 알 수 있습니다. 다만 레이아웃, 간격, 색상 세부 조정은 여전히 Figma에서 하게 됩니다.

개발자 — 디자인 시안을 받은 후, 구현 시작점 생성 도구로 활용

"이 Figma 시안에 TextField 2개, Button, Card로 구성된 폼이 있네" → Playground에서 자연어로 설명 → 뼈대 코드가 나옴 → 거기서부터 세부 조정.

전제 조건

  • Tailwind CSS v4
  • 디자인 토큰 CSS (packages/ui/tailwind/ 하위 파일들을 프로젝트에 복사)

컴포넌트 목록

컴포넌트 설명
Accordion 접기/펼치기 패널
Alert Dialog 확인/취소가 필요한 알림
Avatar 사용자 프로필 이미지
Breadcrumb 경로 탐색
Button 버튼 (아이콘 버튼, 로딩 상태 지원)
Card 카드 컨테이너
Checkbox 체크박스
Checkbox Group 체크박스 그룹
Combobox 검색 가능한 드롭다운
Data Table 정렬/페이지네이션 테이블
Dialog 모달 다이얼로그
Field 폼 필드 (label, description, error)
Input 텍스트 입력 필드
Menu 컨텍스트 메뉴
Panel 패널 컨테이너
Popover 팝오버
Radio 라디오 버튼 그룹
Select 드롭다운 선택
Separator 구분선
Slider 슬라이더
Stack Flex 레이아웃 컨테이너
Switch 토글 스위치
Table 기본 테이블
Tabs 탭 네비게이션
Theme Toggle 다크/라이트 모드 전환
Toast 토스트 알림
Tooltip 툴팁

Playground — 어떻게 동작하는가

packages/json-render가 Playground를 가능하게 합니다:

  1. catalog — 각 컴포넌트의 props와 설명을 Zod 스키마로 정의. AI가 "어떤 컴포넌트를 쓸 수 있는지" 알게 해줌
  2. registry — catalog의 스키마와 실제 React 컴포넌트를 연결. AI가 생성한 JSON spec을 화면에 렌더링
자연어 프롬프트
  → catalog 기반으로 AI에게 사용 가능한 컴포넌트 전달
  → AI가 JSON spec 생성 (컴포넌트 트리)
  → registry가 JSON → React 렌더링

기술 스택

프로젝트 구조

packages/
  ui/                # 컴포넌트 라이브러리
    components/      # 컴포넌트 파일 (하나씩 복사해서 사용)
    tailwind/        # 디자인 토큰 (색상, 타이포, 그림자)
    utils/           # cn() 유틸리티
  json-render/       # AI 기반 UI 생성 (playground용)
apps/
  docs/              # 문서 사이트 (Next.js)

로컬 개발

bun install
bun run dev       # 문서 사이트 로컬 실행
bun run check     # 린트

FAQ

Q. npm 패키지로 설치하는 게 아닌가요?

아닙니다. Playground에서 생성된 코드나 개별 컴포넌트를 복사해서 프로젝트에 넣는 방식입니다. 이렇게 하면:

  • 프로젝트별로 자유롭게 커스터마이징 가능
  • 패키지 버전 업데이트로 인한 breaking change 없음
  • MVP 단계에서 API가 바뀌어도 기존 프로젝트에 영향 없음

안정화 이후 패키지화 여부는 별도 논의합니다.

Q. Playground에서 생성된 결과가 마음에 안 들면?

생성된 코드는 시작점입니다. 복사 후 자유롭게 수정하세요. 개별 컴포넌트의 props와 variant는 문서 사이트에서 확인할 수 있습니다.

About

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0