Orbs / ORB-07

ORB-07

a twist wave travelling out through the ball around a lit column

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, orb07 } from "react-native-shader-orbs";

typescript

<ShaderOrb orb={orb07} 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`	Cell shimmer integrated	0.015 to 10	0.05	0.5
`wave`	Wave speed integrated	0 to 8	0.03	0.7
`twist`	Twist	0 to 8	0.02	1
`spin`	Roll integrated	0 to 3	0.015	0.1
`tilt`	Axis lean	-1.5 to 1.5	0.015	0.3
`camDist`	Camera distance	1 to 50	0.3	7
`focal`	Lens	0.15 to 15	0.1	2.25
`turb`	Cell turbulence	0 to 5	0.03	1
`column`	Column release	0 to 1	0.01	0
`stepScale`	Step scale	0.005 to 1.5	0.005	0.1
`hueDepth`	Depth hue	0 to 10	0.03	0.75
`hueStep`	Step hue	0 to 10	0.03	0.45
`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	10	400
`scatter`	Diffusion	0 to 0.5	0.003	0.01
`exposure`	Exposure	1.5 to 5000	5	60
`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-07 in the playground.