Skip to content

API Options

All adapters accept the same renderer options.

OptionTypeDescription
theme"ice" | "gold" | "prism" | "mono"Preset material direction.
palettePartial<NeoDiscoPalette>Override base, mirror, glow, wire, or shadow colors.
sizenumber | "auto"Square CSS size or host-filling responsive mode.
pixelRationumberCanvas resolution multiplier, clamped internally.
radiusnumberBall radius relative to canvas size.
tileRowsnumberNumber of horizontal mirror bands.
tileColumnsnumberNumber of vertical mirror columns.
tileGapnumberSeparation between mirror tiles.
rotationnumberInitial sphere rotation.
rotationSpeednumberAnimation speed in radians-ish per second.
tiltnumberVertical tilt for perspective.
contrastnumberLight/dark intensity across mirrored tiles.
glownumberFlare and glow strength.
sparklenumberFrequency of flashing highlight tiles.
cordbooleanDraw the hanging cord and cap.
backgroundboolean | stringDraw the built-in background or provide a CSS color.
pausedbooleanRender without running animation.
seednumberStable random layout for tiles.
canvasClassNamestringClass applied to the generated canvas.
canvasStylePartial<CSSStyleDeclaration>Inline styles applied to the generated canvas.
interface NeoDiscoPalette {
base: string;
mirror: string[];
glow: string;
wire: string;
shadow: string;
}