Installation
Choose your framework. The registry installs the component and its runtime dependency.
Installation unavailable
The preview is public, but its installable release is still being prepared.
The registry command writes the component to src/lib/components/ui/Globe.svelte and installs its dependencies.
The registry command writes the component to src/components/ui/Globe.tsx and installs its dependencies.
The registry command writes the component to src/components/ui/Globe.vue and installs its dependencies.
Basic usage
The shader fills its parent. Your layout decides whether that parent is a card, hero, or viewport.
Component API
Types below match the selected Svelte component.
Additional classes for the parent-sized root element.
- Type
string
Locks vertical rotation at the current angle while allowing horizontal orbit.
- Type
boolean- Default
true
Automatic rotation in degrees per second. A released spin eases into this speed in the direction of the gesture.
- Type
number- Default
8- Range / values
0–30
Starting longitude in degrees. Adjust it to bring a continent into view.
- Type
number- Default
-18- Range / values
-180–180
Globe size relative to the shorter side of its container.
- Type
number- Default
2- Range / values
0.25–2
Horizontal position as a fraction of the container's shorter side.
- Type
number- Default
0- Range / values
-1–1
Vertical position as a fraction of the container's shorter side. Positive values move down.
- Type
number- Default
0.5- Range / values
-1–1
Number of evenly spaced points across the whole sphere. Higher values make the land more detailed.
- Type
number- Default
64000- Range / values
2000–64000
Size of each land dot relative to the space between points.
- Type
number- Default
1.2- Range / values
0.2–1.8
Vertical exaggeration of geographic elevation. 1 uses Earth's proportions; 0 flattens the terrain.
- Type
number- Default
60- Range / values
0–150
How far a click lifts the land dots. Set to zero to disable click waves.
- Type
number- Default
1- Range / values
0–2
Brightness of the continents before bloom and exposure are applied.
- Type
number- Default
1.8- Range / values
0–8
Base color of the sphere between continents.
- Type
string- Default
"#363764"
Color of the land dots.
- Type
string- Default
"#C2C6FF"
Color of the illuminated rim.
- Type
string- Default
"#9084FF"
Color of the soft light outside the globe.
- Type
string- Default
"#9084FF"
Brightness of the thin atmospheric rim inside the globe's edge.
- Type
number- Default
1.5- Range / values
0–3
Strength of the atmospheric glow beyond the globe's edge.
- Type
number- Default
1.1- Range / values
0–4
Spread of the outer glow relative to the globe's radius.
- Type
number- Default
0.45- Range / values
0.05–1.5
Minimum brightness that contributes to the glow around land and atmosphere.
- Type
number- Default
0.45- Range / values
0.2–0.95
Width of the transition into the extracted highlights.
- Type
number- Default
0.4- Range / values
0.01–0.4
Spread of the four bloom layers in CSS pixels, independent of screen density.
- Type
number- Default
12- Range / values
0–48
Strength of the glow scattered from bright land and atmosphere. Set to zero to disable bloom.
- Type
number- Default
3- Range / values
0–3
Overall brightness before highlights are compressed to the display range.
- Type
number- Default
1- Range / values
0.25–3
Applies a filmic contrast curve to colors and highlights.
- Type
boolean- Default
false
Stops the render loop while keeping the current frame visible.
- Type
boolean- Default
false
Drag to rotate or click to send a shockwave across the globe. Automatic rotation continues when disabled.
- Type
boolean- Default
true- Range / values
true, false
Caps render resolution independently from the element size.
- Type
number- Default
2- Range / values
1–3
Scales GPU resolution without changing layout dimensions.
- Type
number- Default
1- Range / values
0.25–1
Runs after the shader is mounted successfully, including a WebGL fallback.
- Type
(backend: ShaderBackend) => void- Range / values
webgpu, webgl
Runs when automatic initialization changes the requested WebGPU backend to WebGL.
- Type
(backend: ShaderBackend, reason: string) => void- Range / values
webgl
Reports source-loading or renderer failures so the host application can decide how to recover.
- Type
(error: Error) => void
Exposes the imperative component lifecycle methods.
- Type
Component public instance- Range / values
pause, resume, reset, resize, destroy
Types below match the selected React component.
Additional classes for the parent-sized root element.
- Type
string
Locks vertical rotation at the current angle while allowing horizontal orbit.
- Type
boolean- Default
true
Automatic rotation in degrees per second. A released spin eases into this speed in the direction of the gesture.
- Type
number- Default
8- Range / values
0–30
Starting longitude in degrees. Adjust it to bring a continent into view.
- Type
number- Default
-18- Range / values
-180–180
Globe size relative to the shorter side of its container.
- Type
number- Default
2- Range / values
0.25–2
Horizontal position as a fraction of the container's shorter side.
- Type
number- Default
0- Range / values
-1–1
Vertical position as a fraction of the container's shorter side. Positive values move down.
- Type
number- Default
0.5- Range / values
-1–1
Number of evenly spaced points across the whole sphere. Higher values make the land more detailed.
- Type
number- Default
64000- Range / values
2000–64000
Size of each land dot relative to the space between points.
- Type
number- Default
1.2- Range / values
0.2–1.8
Vertical exaggeration of geographic elevation. 1 uses Earth's proportions; 0 flattens the terrain.
- Type
number- Default
60- Range / values
0–150
How far a click lifts the land dots. Set to zero to disable click waves.
- Type
number- Default
1- Range / values
0–2
Brightness of the continents before bloom and exposure are applied.
- Type
number- Default
1.8- Range / values
0–8
Base color of the sphere between continents.
- Type
string- Default
"#363764"
Color of the land dots.
- Type
string- Default
"#C2C6FF"
Color of the illuminated rim.
- Type
string- Default
"#9084FF"
Color of the soft light outside the globe.
- Type
string- Default
"#9084FF"
Brightness of the thin atmospheric rim inside the globe's edge.
- Type
number- Default
1.5- Range / values
0–3
Strength of the atmospheric glow beyond the globe's edge.
- Type
number- Default
1.1- Range / values
0–4
Spread of the outer glow relative to the globe's radius.
- Type
number- Default
0.45- Range / values
0.05–1.5
Minimum brightness that contributes to the glow around land and atmosphere.
- Type
number- Default
0.45- Range / values
0.2–0.95
Width of the transition into the extracted highlights.
- Type
number- Default
0.4- Range / values
0.01–0.4
Spread of the four bloom layers in CSS pixels, independent of screen density.
- Type
number- Default
12- Range / values
0–48
Strength of the glow scattered from bright land and atmosphere. Set to zero to disable bloom.
- Type
number- Default
3- Range / values
0–3
Overall brightness before highlights are compressed to the display range.
- Type
number- Default
1- Range / values
0.25–3
Applies a filmic contrast curve to colors and highlights.
- Type
boolean- Default
false
Stops the render loop while keeping the current frame visible.
- Type
boolean- Default
false
Drag to rotate or click to send a shockwave across the globe. Automatic rotation continues when disabled.
- Type
boolean- Default
true- Range / values
true, false
Caps render resolution independently from the element size.
- Type
number- Default
2- Range / values
1–3
Scales GPU resolution without changing layout dimensions.
- Type
number- Default
1- Range / values
0.25–1
Runs after the shader is mounted successfully, including a WebGL fallback.
- Type
(backend: ShaderBackend) => void- Range / values
webgpu, webgl
Runs when automatic initialization changes the requested WebGPU backend to WebGL.
- Type
(backend: ShaderBackend, reason: string) => void- Range / values
webgl
Reports source-loading or renderer failures so the host application can decide how to recover.
- Type
(error: Error) => void
Exposes the imperative component lifecycle methods.
- Type
GlobeHandle- Range / values
pause, resume, reset, resize, destroy
Types below match the selected Vue component.
Additional classes for the parent-sized root element.
- Type
string
Locks vertical rotation at the current angle while allowing horizontal orbit.
- Type
boolean- Default
true
Automatic rotation in degrees per second. A released spin eases into this speed in the direction of the gesture.
- Type
number- Default
8- Range / values
0–30
Starting longitude in degrees. Adjust it to bring a continent into view.
- Type
number- Default
-18- Range / values
-180–180
Globe size relative to the shorter side of its container.
- Type
number- Default
2- Range / values
0.25–2
Horizontal position as a fraction of the container's shorter side.
- Type
number- Default
0- Range / values
-1–1
Vertical position as a fraction of the container's shorter side. Positive values move down.
- Type
number- Default
0.5- Range / values
-1–1
Number of evenly spaced points across the whole sphere. Higher values make the land more detailed.
- Type
number- Default
64000- Range / values
2000–64000
Size of each land dot relative to the space between points.
- Type
number- Default
1.2- Range / values
0.2–1.8
Vertical exaggeration of geographic elevation. 1 uses Earth's proportions; 0 flattens the terrain.
- Type
number- Default
60- Range / values
0–150
How far a click lifts the land dots. Set to zero to disable click waves.
- Type
number- Default
1- Range / values
0–2
Brightness of the continents before bloom and exposure are applied.
- Type
number- Default
1.8- Range / values
0–8
Base color of the sphere between continents.
- Type
string- Default
"#363764"
Color of the land dots.
- Type
string- Default
"#C2C6FF"
Color of the illuminated rim.
- Type
string- Default
"#9084FF"
Color of the soft light outside the globe.
- Type
string- Default
"#9084FF"
Brightness of the thin atmospheric rim inside the globe's edge.
- Type
number- Default
1.5- Range / values
0–3
Strength of the atmospheric glow beyond the globe's edge.
- Type
number- Default
1.1- Range / values
0–4
Spread of the outer glow relative to the globe's radius.
- Type
number- Default
0.45- Range / values
0.05–1.5
Minimum brightness that contributes to the glow around land and atmosphere.
- Type
number- Default
0.45- Range / values
0.2–0.95
Width of the transition into the extracted highlights.
- Type
number- Default
0.4- Range / values
0.01–0.4
Spread of the four bloom layers in CSS pixels, independent of screen density.
- Type
number- Default
12- Range / values
0–48
Strength of the glow scattered from bright land and atmosphere. Set to zero to disable bloom.
- Type
number- Default
3- Range / values
0–3
Overall brightness before highlights are compressed to the display range.
- Type
number- Default
1- Range / values
0.25–3
Applies a filmic contrast curve to colors and highlights.
- Type
boolean- Default
false
Stops the render loop while keeping the current frame visible.
- Type
boolean- Default
false
Drag to rotate or click to send a shockwave across the globe. Automatic rotation continues when disabled.
- Type
boolean- Default
true- Range / values
true, false
Caps render resolution independently from the element size.
- Type
number- Default
2- Range / values
1–3
Scales GPU resolution without changing layout dimensions.
- Type
number- Default
1- Range / values
0.25–1
Runs after the shader is mounted successfully, including a WebGL fallback.
- Type
(backend: ShaderBackend) => void- Range / values
webgpu, webgl
Runs when automatic initialization changes the requested WebGPU backend to WebGL.
- Type
(backend: ShaderBackend, reason: string) => void- Range / values
webgl
Reports source-loading or renderer failures so the host application can decide how to recover.
- Type
(error: Error) => void
Exposes the imperative component lifecycle methods.
- Type
Component public instance- Range / values
pause, resume, reset, resize, destroy