Orbs / ORB-04

ORB-04

a hollow shell of light, faceted by a voxel lattice

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

typescript

<ShaderOrb orb={orb04} 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.6
`camDist`	Camera distance	1 to 60	0.3	9
`focal`	Lens	0.15 to 15	0.05	1.35
`shellR`	Shell radius	0.3 to 20	0.1	5
`pitch`	Facet size	0.005 to 1.5	0.005	0.3
`turb`	Displacement	0 to 5	0.02	0.45
`slack`	Trace slack	0.01 to 0.9	0.005	0.1
`width`	Surface width	0.001 to 0.3	0.001	0.003
`hueGain`	Position hue	0 to 6	0.02	1
`floorLevel`	White floor	0 to 4	0.02	0.8
`envScale`	Silhouette margin	1 to 2	0.01	1.16
`exposure`	Exposure	20 to 40000	20	3000
`contrast`	Contrast	0.15 to 15	0.1	1.3
`saturation`	Saturation	0 to 4	0.02	1.3
`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-04 in the playground.