출처
- source_url: https://github.com/vercel-labs/json-render
- 저장소: vercel-labs/json-render (Stars 18,329 · License Apache-2.0 · Language TypeScript)
- 저장소 생성: 2026-01-14 · 최근 push: 2026-09-25 (최근 릴리스 v0.21.0, 2026-09-18)
- Homepage: https://json-render.dev
- raw: 2026-09-27-github-vercel-labs-json-render
개요
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 생태계와의 접점을 보여준다.
관련 링크 및 키워드
- json-render 공식 사이트/문서
- json-render GitHub 저장소
- 키워드: generative UI, JSON spec, component catalog, guardrailed AI output, streaming render, cross-platform renderer, MCP Apps