@json-render/shadcn-svelte API

Pre-built shadcn-svelte components for json-render. 36 components built on Svelte 5 + Tailwind CSS, ready to use with defineCatalog and defineRegistry.

Installation

npm install @json-render/shadcn-svelte @json-render/core @json-render/svelte zod

Your app must have Tailwind CSS configured.

Entry Points

Entry Point	Exports	Use For
`@json-render/shadcn-svelte`	`shadcnComponents`, `shadcnComponentDefinitions`	Svelte implementations + catalog schemas
`@json-render/shadcn-svelte/catalog`	`shadcnComponentDefinitions`	Catalog schemas only (no Svelte dependency, safe for server)

Usage

Pick the components you need from the standard definitions:

import { defineCatalog } from "@json-render/core";
import { schema } from "@json-render/svelte/schema";
import { shadcnComponentDefinitions } from "@json-render/shadcn-svelte/catalog";
import { defineRegistry } from "@json-render/svelte";
import { shadcnComponents } from "@json-render/shadcn-svelte";

// Catalog: pick definitions
const catalog = defineCatalog(schema, {
  components: {
    Card: shadcnComponentDefinitions.Card,
    Stack: shadcnComponentDefinitions.Stack,
    Heading: shadcnComponentDefinitions.Heading,
    Button: shadcnComponentDefinitions.Button,
    Input: shadcnComponentDefinitions.Input,
  },
  actions: {},
});

// Registry: pick matching implementations
const { registry } = defineRegistry(catalog, {
  components: {
    Card: shadcnComponents.Card,
    Stack: shadcnComponents.Stack,
    Heading: shadcnComponents.Heading,
    Button: shadcnComponents.Button,
    Input: shadcnComponents.Input,
  },
});

Then render in your Svelte component:

<script lang="ts">
  import { Renderer, JsonUIProvider } from "@json-render/svelte";

  export let spec;
  export let registry;
</script>

<JsonUIProvider initialState={spec?.state ?? {}}>
  <Renderer {spec} {registry} />
</JsonUIProvider>

Available Components

Layout

Component	Description
`Card`	Container card with optional title, description, maxWidth, centered
`Stack`	Flex container with direction, gap, align, justify
`Grid`	Grid layout with columns (1-6) and gap
`Separator`	Visual separator line with orientation

Component	Description
`Tabs`	Tabbed navigation with tabs array, defaultValue, value
`Accordion`	Collapsible sections with items array and type (single/multiple)
`Collapsible`	Single collapsible section with title and defaultOpen
`Pagination`	Page navigation with totalPages and page

Overlay

Component	Description
`Dialog`	Modal dialog with title, description, openPath
`Drawer`	Bottom drawer with title, description, openPath
`Tooltip`	Hover tooltip with content and text
`Popover`	Click-triggered popover with trigger and content
`DropdownMenu`	Dropdown menu with label and items array

Content

Component	Description
`Heading`	Heading text with level (h1-h4)
`Text`	Paragraph with variant (body, caption, muted, lead, code)
`Image`	Image with alt, width, height
`Avatar`	User avatar with src, name, size
`Badge`	Status badge with text and variant
`Alert`	Alert banner with title, message, type
`Carousel`	Horizontally scrollable carousel with items
`Table`	Data table with columns and rows

Feedback

Component	Description
`Progress`	Progress bar with value, max, label
`Skeleton`	Loading placeholder with width, height, rounded
`Spinner`	Loading spinner with size and label

Input

Component	Description
`Button`	Clickable button with label, variant, disabled
`Link`	Anchor link with label and href
`Input`	Text input with label, name, type, placeholder, value, checks
`Textarea`	Multi-line text input with label, name, placeholder, rows, value, checks
`Select`	Dropdown select with label, name, options, value, checks
`Checkbox`	Checkbox with label, name, checked
`Radio`	Radio button group with label, name, options, value
`Switch`	Toggle switch with label, name, checked
`Slider`	Range slider with label, min, max, step, value
`Toggle`	Toggle button with label, pressed, variant
`ToggleGroup`	Group of toggle buttons with items, type, value
`ButtonGroup`	Group of buttons with buttons array and selected

Notes

The /catalog entry point has no Svelte dependency -- use it for server-side prompt generation
Components use Tailwind CSS classes -- your app must have Tailwind configured
Component implementations use bundled shadcn-svelte primitives (not your app's $lib/components/ui/)
Form inputs support checks for validation (type + message pairs) and validateOn for timing
Events: inputs emit change/submit/focus/blur; buttons emit press; selects emit change/select