jomvick/design-oracle

웹사이트를 분석해 디자인 시스템(색상, 타이포그래피, 컴포넌트)을 자동 추출해 Tailwind·React·디자인 토큰으로 내보내는 도구

완성 앱맘대로 써도 됨 · MIT웹·Next.js·풀스택TypeScript난이도
39+3이번 주0 찜
1포크0이슈

중간맛 분석

스택: Next.js 15 + FastAPI + ARQ(비동기 큐) + Redis + Playwright

한눈에: URL 하나만 제공하면 풀페이지 스크린샷을 분석해 색상·타이포그래피·간격·컴포넌트(헤로, 네비게이션, FAQ 등)를 감지한 후 Tailwind v4 설정파일, React JSX, JSON 토큰, Markdown 보고서로 내보냅니다. 진행 상황을 SSE 스트림으로 실시간 표시.

바로 쓸 수 있나: 네, Compose로 한 줄이면 http://localhost:3000 에서 웹 UI 즉시 사용 가능.

데모: GIF 예시 포함되어 있으며, 분석 결과는 analyses/{id}/ 에 스크린샷, JSON, Markdown, 생성된 컴포넌트 파일 저장.

이런 레포예요

이럴 때 쓰면 좋아요

  • 기존 웹사이트의 디자인 시스템을 역으로 추출해 Tailwind 설정으로 빠르게 이식
  • 경쟁사 또는 참고 사이트의 컬러·타이포그래피·컴포넌트 패턴을 분석해 디자인 가이드 작성
  • AI 에이전트(Cursor, Claude Code)에 MCP 서버로 연결해 자동 UI 분석·코드 생성 워크플로우 구축

핵심 기능

Playwright 기반 전체 페이지 분석 및 컴포넌트 감지 (바운딩박스 포함)Tailwind v4·React JSX·JSON 토큰·Markdown 보고서 다중 형식 내보내기MCP 서버 통합으로 AI 에이전트 직접 연결 가능

대안 대비 차별점

웹사이트 디자인을 추출하는 것을 넘어, 구성된 디자인 시스템(Tailwind config, React 컴포넌트)으로 즉시 변환하고 AI 워크플로우(MCP)에 통합할 수 있는 엔드-투-엔드 파이프라인을 제공합니다.

먹어본 사람들

실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.

시식평 · 먹어본 사람 한마디

아직 시식평이 없어요. 먹어보셨다면 첫 한마디를 남겨주세요.

다른 레포 시식평 구경하기 →

이 레포로 만든 것들

🖋 완주 인증하기

아직 이 레포로 만든 완주 인증이 없어요. 첫 밥도장을 찍어보세요!

이 레포, 해먹는 법

처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.

준비물

  • Python 3.12+ (로컬 실행 시)
  • Node.js 20+ (로컬 실행 시)
  • Redis 7+ (로컬 실행 시 또는 Docker)
  • Docker & Docker Compose (Docker 방식)

바로 차려먹기Docker Compose

깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.

git clone --depth 1 https://github.com/jomvick/design-oracle.git &&
cd design-oracle &&
docker compose up

Docker가 필요해요 — 맥이라면 OrbStack(brew install --cask orbstack)을 추천해요.

코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.

README가 안내하는 자세한 단계 보기
  1. 저장소 클론
git clone https://github.com/jomvick/design-oracle.git
cd design-oracle
  1. 환경변수 설정 (선택사항 — Docker에서는 기본값 적용)
cp .env.example .env
  1. Docker Compose로 전체 스택 실행
docker compose up --build -d
  1. 브라우저에서 접속
http://localhost:3000

또는 로컬 실행 (Python 3.12+, Node.js 20+, Redis 7+ 필수):

  1. 환경변수 설정
cp .env.example .env
  1. start.sh 실행 (venv 생성, 의존성 설치, 전체 서비스 시작)
./start.sh
  1. http://localhost:3000 접속 후 멈추려면 Ctrl+C 입력

깃밥트라이로 맛보기

받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.

터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.

npx gitbap-try jomvick/design-oracle

Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →

별 추이 · 7일

39+3 / 7일

활용성 · 따라 만들기 좋은가

따라 하기 좋음샘플 점수 46/100
  • 관대한 라이선스
  • 테스트 있음
  • 예제 디렉토리
  • 최근 활동
  • AGENTS.md
  • llms.txt
  • 템플릿

🟢 최근 활동 있음 · 2026년 생성

「웹·Next.js·풀스택」 이런 레포, 매주 받아보실래요?

매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.

내 레포인가요? README에 깃밥 배지 달기
[![깃밥](https://www.gitbap.com/badge/jomvick/design-oracle.svg)](https://www.gitbap.com/r/jomvick/design-oracle)
🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법

깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.

방법 ① 커넥터 URL

클로드 설정 → 커넥터에 이 주소를 붙여넣기.

https://www.gitbap.com/api/mcp
방법 ② 플러그인 (체험까지)

플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
연결 방법 자세히 →

AI가 README 기반으로 요약했습니다 · 원문 보기