Orbs / ORB-22

ORB-22

field lines swirling around the ball about a wandering axis

WebGPU isn't available in this browser

Installation

bash

npx expo install react-native-shader-orbs react-native-webgpu react-native-reanimated react-native-worklets

Usage

typescript

import { ShaderOrb, orb22 } from "react-native-shader-orbs";

typescript

<ShaderOrb orb={orb22} size={280} state="idle" interactive />

Props

Component props

The props you'll use most. The ShaderOrb reference lists all of them.

Prop	Type	Default	Description
`state`	`"idle" \| "thinking" \| "speaking"`	`"idle"`	The mood. Eases the parameters toward that preset.
`size`	`number`	`280`	Width and height in points.
`params`	`Record<string, number>`		Parameter overrides by key, clamped to each range. See the shader params below.
`colors`	`Record<string, string>`		Hex colors by key. See the colors below.
`volumes`	`{ input?: number; output?: number }`		Levels from 0 to 1 that the shader reads as input and output loudness.
`interactive`	`boolean`	`false`	Tap pulses the orb; holding makes it swell.
`quality`	`"auto" \| "low" \| "medium" \| "high" \| number`	`"auto"`	Render scale. Lower is cheaper and softer.
`maxFps`	`number`	`60`	Frame cap.
`paused`	`boolean`	`false`	Stops drawing and keeps the last frame.
`onReady`	`() => void`		Called once the first frame is on screen.
`onError`	`(error: Error) => void`		Called if the orb can't start. Without it the error is logged once.

Shader params

Pass these through params. Values are clamped to the range shown. integrated parameters are phase clocks: the shader accumulates them over time, so the value acts as a rate.

Key	Label	Range	Step	Default
`speed`	Anim speed integrated	0.015 to 10	0.05	0.5
`wander`	Axis wander integrated	0 to 3	0.015	0.12
`camDist`	Camera distance	1 to 50	0.3	7
`focal`	Lens	0.15 to 15	0.1	2.25
`hug`	Surface hug	0 to 3	0.015	0.8
`turb`	Cell shimmer	0 to 5	0.03	0.6
`stepScale`	Step scale	0.005 to 1.5	0.01	0.07
`hueStep`	Step hue	0 to 10	0.03	0.12
`hueDepth`	Depth hue	0 to 10	0.03	1.4
`glow`	Vector glow	0 to 10	0.05	1.4
`glowFew`	Glow density	0 to 1.5	0.01	0.12
`envRadius`	Envelope radius	0.15 to 15	0.1	2.6
`envCore`	Envelope core	0.3 to 1.02	0.01	0.88
`fill`	Body fill	0 to 100	0.3	0.15
`stepClamp`	Step clamp	3 to 5000	30	800
`scatter`	Diffusion	0 to 0.5	0.003	0.01
`exposure`	Exposure	1.5 to 5000	15	260
`contrast`	Contrast	0.15 to 15	0.1	1.3
`saturation`	Saturation	0 to 4	0.02	1.15
`alphaGain`	Alpha gain	0.05 to 15	0.1	2
`edge`	Edge sharpness	0 to 1	0.01	1
`edgeFade`	Halo falloff	0.1 to 0.985	0.015	0.98

Colors

Pass these through colors as hex strings.

Key	Label	Default
`tint`	Tint	`#ffffff`

Moods

This orb ships presets for idle, speaking, thinking. Choosing a state eases the parameters toward that preset; anything you pass in params still wins.

Credits

Based on original work by XorDev, via shadercn. The shader is licensed for non-commercial use with attribution; see Licensing and credits.

Ported to React Native by @msobkyy.

Want to change something? Open ORB-22 in the playground.