출처

개요

json-render는 Vercel Labs가 공개한 Generative UI 프레임워크다. LLM이 자연어 프롬프트로부터 UI를 생성하되, 개발자가 미리 정의한 컴포넌트 카탈로그 안에서만 동작하도록 제약해 신뢰성을 확보한다. defineCatalog로 Zod 스키마 기반 컴포넌트·액션 카탈로그를 정의하면, AI는 그 카탈로그로 제약된 JSON spec(root + elements 플랫 트리)만 생성하고, Renderer가 이를 스트리밍 파싱해 점진적으로 렌더링한다. React, Vue, Svelte, Solid(웹)와 React Native(모바일)가 동일한 카탈로그를 공유하며, shadcn/ui 기반 사전 빌드 컴포넌트 36개도 함께 제공된다.

핵심 포인트

  • 가드레일 3단계 흐름: defineCatalog(허용 컴포넌트/액션 정의) → defineRegistry(실제 렌더링 구현 등록) → <Renderer spec registry>(AI가 생성한 JSON spec 렌더링). catalog.prompt()가 컴포넌트 설명·props 스키마· 가능한 액션을 포함한 시스템 프롬프트를 자동 생성한다.
  • 스트리밍(SpecStream): createSpecStreamCompiler()로 모델 응답 청크를 실시간 파싱해 UI를 점진적으로 갱신 — 응답이 끝나기 전에도 렌더링 시작.
  • Dynamic Props 표현식: $state(상태 읽기), $cond/$then/$else(조건 분기), $template(문자열 보간), $computed(등록 함수 호출)로 모든 prop 값을 데이터 기반으로 구성. visible 필드로 상태 기반 조건부 표시, 엘리먼트의 watch 필드로 상태 변경 시 액션 자동 트리거(초기 렌더는 미발동) 가능.
  • 30여 개 패키지 생태계: 웹(React/Vue/Svelte/Solid/shadcn), 모바일(React Native), 풀스택 앱(Next.js, TanStack Start — 라우트/레이아웃/SSR까지 JSON 으로), 비디오(Remotion), 문서(React PDF), 이메일(React Email), 터미널 (Ink), 이미지(Satori 기반 SVG/PNG), 3D(React Three Fiber, GaussianSplat 포함)까지 렌더러를 확장. 상태관리 어댑터(Redux/Zustand/Jotai/XState), 프레임워크 무관 devtools, MCP Apps 통합(@json-render/mcp — Claude, ChatGPT, Cursor, VS Code)도 포함.
  • 디렉티브·코드젠: @json-render/directives가 $format $math $concat $count $truncate $pluralize $join $t(i18n) 같은 사전 빌드 디렉티브를 제공하고, @json-render/codegen은 json-render UI 트리를 실제 코드로 변환하는 유틸을 제공한다.
  • How It Works: 가드레일 정의 → 프롬프트 → AI가 제약된 JSON 생성 → 스트리밍 렌더의 4단계 루프로 요약된다.

왜 중요한가

Generative UI의 핵심 난제는 “LLM이 자유롭게 UI를 만들게 하면 예측 불가능한 출력이 나온다”는 것인데, json-render는 카탈로그로 컴포넌트 공간을 제한해 스키마 일치를 보장하는 접근을 취한다. 동일 카탈로그를 웹·모바일·비디오· PDF·이메일·터미널·3D까지 공유하는 점이 특징으로, 하나의 spec 포맷으로 여러 출력 표면을 커버하려는 시도다. OpenUI 가 이 프로젝트를 토큰 효율성 벤치마크의 비교 기준(JSON 방식 대표)으로 삼은 데서 보듯, json-render는 JSON 기반 Generative UI 진영의 대표 주자로 자주 인용된다. @json-render/mcp를 통해 MCP Apps(Claude/ChatGPT/Cursor/ VS Code)와 직접 연결되는 점도 AI 에이전트 UI 생태계와의 접점을 보여준다.

관련 링크 및 키워드