본문 바로가기
← 프로젝트

오픈소스운영 중2026.08.05 ~v0.2.1 · 1년 다운로드 877회

react-device-check

Mac 인 척하는 iPad, 모델명이 지워진 안드로이드 UA, 삼성 DeX 까지 가려내는 기기 판별 훅입니다.

소개

사용자가 폰 · 태블릿 · 데스크톱 중 무엇을 쓰는지, OS 는 무엇인지 알려 주는 React 훅 라이브러리입니다.
Mac 으로 위장하는 iPad, 모델명이 지워진 안드로이드 UA, Next.js 의 hydration 에러를 풀려고 만들었습니다.
판별은 Client Hints, UA 문자열, maxTouchPoints 를 차례로 확인합니다.

기능

  • useDevice 하나로 판별type · os · isMobile 같은 기기 정보와 화면 방향을 한 번에 받습니다.
  • 의존성 없는 작은 번들전체가 약 1.6 kB 이고, useIsMobile 하나만 쓰면 약 1.1 kB 입니다.
  • SSR 안전서버와 첫 화면이 같은 기본값을 써서 Next.js 에서 hydration 에러가 나지 않습니다.
  • iPad 위장 판별Mac 을 자처하는 iPad 를 maxTouchPoints 와 화면 길이로 가려냅니다.
  • 화면 밀도 훅useDevicePixelRatio 는 줌 · 배율 변화를 따라갑니다.
  • React 없는 판별 엔진detectDevice 에 요청 UA 를 넘기면 서버 미들웨어에서도 판별합니다.

기술

  • React
  • TypeScript
  • Vite
  • Vitest
  • Playwright