vercel-labs / vercel-labs/json-render
feat: Claude Code skills for catalog design + multi-surface rendering
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 16.8k
- Forks
- 901
- Avg merge
- 3h 14m
- Merged PRs (30d)
- 4
Description
Proposal
We've built two complementary Claude Code skills for json-render and would like to contribute them upstream.
Skill 1: json-render-catalog (component catalog patterns)
Guides AI agents through building Zod-typed catalogs:
- Catalog design patterns (constrain AI output to design system)
- shadcn component mapping (29 built-in → custom extensions)
- Token optimization (YAML wire format saves ~30% vs JSON)
- Action definitions with typed params
- Catalog validation and testing patterns
- Multi-framework support (React, Vue, Svelte, React Native)
Skill 2: multi-surface-render (one spec, 6 outputs)
Same JSON spec → multiple output surfaces:
- React — web UI rendering with
<Renderer> - PDF —
renderToPdfBuffer()for reports, invoices - Email —
renderToEmailHtml()+renderToEmailText()via react-email - Image — OG image generation (1200x630) with
@resvg/resvg-js - Terminal — ASCII/Unicode rendering for CLI tools and MCP responses
- YAML — token-efficient wire format for LLM consumption
Includes: registry mapping patterns, renderer selection logic, Edge runtime gotchas (Uint8Array → ArrayBuffer), catalog subsetting per surface.
Tested against
@json-render/* v0.16.0 in production with 41-component catalog, 14 custom HQ components, 6 active output surfaces, 130+ tests.
Format
Two SKILL.md files with references/ and examples/. Happy to PR.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reviewing the two proposed SKILL.md files and their references/ and examples/ directories. Verify that the catalog skill covers typed catalogs, validation, testing, and framework mappings, while the multi-surface skill covers all six output surfaces and the listed runtime considerations; done means both skills are complete and consistent with the tested json-render capabilities.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- developer-experience, documentation
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100