페르소나 리뷰(적대적 검증 통과)에서 정리된 항목입니다.
관점: 사용 개발자(DX) · 구분: 추가희망 · 심각도: medium · 난이도: 낮음
현상
예시 전반이 'use client'를 달지만, WebGL/three 기반 컴포넌트의 SSR 비활성화(next/dynamic ssr:false), CSS import 위치, 'use client' 경계 설계 같은 실전 통합 안내가 없다. README/Welcome.mdx는 설치·단일 예시까지만 다룬다. R3F 라이브러리에서 소비자가 가장 많이 막히는 지점이 SSR이다.
근거
packages/hyperglobe/README.md:41-57; packages/hyperglobe/pages/Welcome.mdx:36-52 (use client만 표기, SSR 안내 없음)
권고
'Next.js와 함께 쓰기' 짧은 가이드를 추가: dynamic(()=>import, {ssr:false}) 패턴, CSS import 위치, 컨테이너 높이 지정 주의 등.
검증 메모
evidence의 파일 경로/줄 범위에 부정확함이 있다. 'packages/hyperglobe/README.md:41-57'로 인용했으나 그 패키지 README는 40줄에서 끝나고 코드 예시 섹션 자체가 없다. 실제 'use client' 코드 예시는 (1) 모노레포 루트 README.md:41-57, (2) packages/hyperglobe/pages/Welcome.mdx:36-52에 있다. 인용 위치만 어긋날 뿐 '예시는 use client만 표기, SSR 안내 없음'이라는 주장 자체는 그대로 성립한다.
관점: 사용 개발자(DX) · 구분: 추가희망 · 심각도: medium · 난이도: 낮음
현상
예시 전반이 'use client'를 달지만, WebGL/three 기반 컴포넌트의 SSR 비활성화(
next/dynamicssr:false), CSS import 위치, 'use client' 경계 설계 같은 실전 통합 안내가 없다. README/Welcome.mdx는 설치·단일 예시까지만 다룬다. R3F 라이브러리에서 소비자가 가장 많이 막히는 지점이 SSR이다.근거
packages/hyperglobe/README.md:41-57; packages/hyperglobe/pages/Welcome.mdx:36-52 (use client만 표기, SSR 안내 없음)
권고
'Next.js와 함께 쓰기' 짧은 가이드를 추가: dynamic(()=>import, {ssr:false}) 패턴, CSS import 위치, 컨테이너 높이 지정 주의 등.
검증 메모
evidence의 파일 경로/줄 범위에 부정확함이 있다. 'packages/hyperglobe/README.md:41-57'로 인용했으나 그 패키지 README는 40줄에서 끝나고 코드 예시 섹션 자체가 없다. 실제 'use client' 코드 예시는 (1) 모노레포 루트 README.md:41-57, (2) packages/hyperglobe/pages/Welcome.mdx:36-52에 있다. 인용 위치만 어긋날 뿐 '예시는 use client만 표기, SSR 안내 없음'이라는 주장 자체는 그대로 성립한다.