Welcome to the @ripple-ui/svelte documentation. Ripple is a Svelte 5 component library that renders interactive UIs from declarative JSON specifications — designed for AI-generated interfaces.
- Getting Started — Installation, basic usage, and your first spec
- Architecture — How Ripple works under the hood
- UISpec Reference (v1.0) — Low-level widget tree specification
- UniversalSpec Reference (v2.0) — High-level intent-based specification
- Widgets — Reference for the 150+ built-in widgets (layout, display, input, data, overlay, composite, research, vertical, control)
- Expressions — Binding syntax, operators, and template strings
- State Management — Reactive state with dot-notation paths
- Event Handling — Actions, chaining, and the event system
- Intent System — Layout engine, pattern detection, and chaining
- Theming — Color tokens, dark mode, and theme overrides
- Custom Widgets — Extending Ripple with your own widgets
- API Reference — All exports, types, and functions
Manifest as source of truth. Every widget's prop schema and runnable example is shipped in
dist/manifest.json(also served at/manifest.jsonin dev). When the docs and the manifest disagree, the manifest is canonical — it's generated from the same TypeScript declarations the runtime consumes.