svelte-tweakpane-ui

Overview

🎛️ Svelte Tweakpane UI wraps user-interface elements from the excellent Tweakpane library in a collection of 33 idiomatic, reactive, type-safe, carefully-crafted, and obsessively-documented Svelte components.

The library makes it easy to quickly and declaratively add knobs and dials to your projects using components that feel like they were made for Svelte. It also augments Tweakpane with a few extra features for your convenience and enjoyment.

The components should be useful for integrating controls and value monitoring in parametrically driven artworks, data visualizations, creative tools, simulations, etc.

The library is compatible with both Svelte 4 and Svelte 5.

Demo

Documentation

**Please see the documentation site for much more information:**
https://kitschpatrol.com/svelte-tweakpane-ui

Quick start

1. Add Svelte Tweakpane UI to your Svelte project:

npm install svelte-tweakpane-ui

2. Import and use Tweakpane components in your .svelte files:

<script lang="ts">
  import { Button } from 'svelte-tweakpane-ui'
</script>

<Button on:click={() => alert('🎛️')} />

Components

Core

• **Binding**
  Wraps the Tweakpane addBinding method.
• **Blade**
  Wraps the Tweakpane addBlade method.
• **Folder**
  Organize multiple controls into a collapsable folder.
• **Pane**
  The root <Pane> component, used for organizing controls into a single group and controlling how and where the Tweakpane is displayed.
• **Separator**
  A convenience component providing a subtle visual separator between controls, in the spirit of the HTML <hr> element.
• **TabGroup**
  Contains a collection of <TabPage> components to be presented as a tabs.
• **TabPage**
  Contains a collection of Tweakpane controls to be presented as a single group inside a <TabGroup> component.

Control

• **Button**
  A humble but effective push button.
• **ButtonGrid**
  A grid of <Button> components.
• **Checkbox**
  A checkbox.
• **Color**
  A color picker.
• **CubicBezier**
  A control for editing a bezier curve. Ideal for tweaking animation easing values.
• **File**
  A file input control.
• **Image**
  An image input control.
• **IntervalSlider**
  A twin-handled slider control for specifying range values.
• **List**
  An option list picker, similar to an HTML <select> element.
• **Point**
  Wraps the Tweakpane point bindings.
• **RadioGrid**
  A grid of radio buttons.
• **Ring**
  A control evoking the focus ring on a proper camera lens.
• **RotationEuler**
  Integrates the euler rotation control from 0b5vr's tweakpane-plugin-rotation.
• **RotationQuaternion**
  Integrates the quaternion rotation control from 0b5vr's tweakpane-plugin-rotation.
• **Slider**
  A slider component providing fine-grained control over numeric values.
• **Stepper**
  A control for simple incremental value changes.
• **Text**
  A text field, in the spirit of the HTML <input type="text"> element.
• **Textarea**
  A multi-line text input field, in the spirit of the HTML <textarea> element.
• **Wheel**
  A control evoking a dial on a proper camera body.

Monitor

• **FpsGraph**
  A control for monitoring and graphing frame rates over time.
• **Monitor**
  Wraps the Tweakpane monitor binding functionality for boolean, number, and string values.
• **Profiler**
  Measure and visualize multiple quantities over time.
• **WaveformMonitor**
  Visualize multiple numeric values as a waveform.

Extra

• **AutoObject**
  Rapid-development component which automatically creates a set of Tweakpane controls for an arbitrary object.
• **AutoValue**
  Rapid-development component which automatically creates a Tweakpane control for an arbitrary value.
• **Element**
  A component for embedding arbitrary HTML elements into a pane.

Maintainers

@kitschpatrol

Acknowledgments

Thank you to Hiroki Kokubun for creating the Tweakpane library.

Additional acknowledgments are listed on the documentation site.

Contributing

Issues are welcome and appreciated.

Please open an issue to discuss changes before submitting a pull request. Unsolicited PRs (especially AI-generated ones) are unlikely to be merged.

This repository uses @kitschpatrol/shared-config (via its ksc CLI) for linting and formatting, plus MDAT for readme placeholder expansion.

License

MIT © Eric Mika

Note: This library is not to be confused with Karl Moore's svelte-tweakpane.