Animations112 / 118
Signal Globe
A holographic dot-matrix Earth: real coastlines drawn in fine rows of light, a burning mint limb, and your locations as pulsing beacons with light running along the arcs between them. Dots lift under your cursor like a lens; drag to spin it, click to send a shock ripple across the continents.
three.jsthree.jsGlobeGlobePointsPointsBloomBloomMarkersMarkersGSAPGSAP
Hover the globe, drag to spin itClick to send a ripple
Tweak
LIVELIVEGlobe
#c4c2ff
#9ff7cf
Markers
#7cf3ff
Arcs
Motion
1.0×
Usage
Follows your tweaks.
usage.tsx
import { SignalGlobe } from "@/components/inreact/signal-globe";
// your locations (lat / lng); arcs run from the first one to the rest
const offices = [
{ lat: 51.5, lng: -0.12 }, // London
{ lat: 40.7, lng: -74 }, // New York
{ lat: 35.7, lng: 139.7 }, // Tokyo
];
export function Presence() {
return (
<section className="h-[600px] bg-black">
<SignalGlobe markers={offices} arcs={true} color="#c4c2ff" rim="#9ff7cf" accent="#7cf3ff" speed={1} />
</section>
);
}Install with the CLI
TS + Tailwind
npx shadcn@latest add https://inreact.vercel.app/r/signal-globe.jsonOr copy the source
Install the dependencies, then save this as components/inreact/signal-globe.tsx.
terminal
npm install gsap threecomponents/inreact/signal-globe.tsx
"use client";
import { gsap } from "gsap";
import { useEffect, useRef } from "react";
import * as THREE from "three";
import { EffectComposer } from "three/addons/postprocessing/EffectComposer.js";
import { OutputPass } from "three/addons/postprocessing/OutputPass.js";
import { RenderPass } from "three/addons/postprocessing/RenderPass.js";
import { UnrealBloomPass } from "three/addons/postprocessing/UnrealBloomPass.js";
/**
* Signal Globe: a holographic dot-matrix Earth, rendered live in three.js. The land is drawn in fine
* rows of light along the latitudes (real coastlines, baked into this file, so nothing loads), the
* oceans are empty, and the limb burns mint where the dots crowd together. Your locations sit on it
* as pulsing beacons, with light running along the arcs between them.
*
* - The dots under your cursor lift off the surface and brighten, like a lens passing over the map.
* - Drag to spin it; it coasts like a body in space and eases back to its own slow turn.
* - Click (or Enter / Space): a shock ripple runs out across the continents from where you clicked,
* and the globe gives a little squash and rebound.
*
* <div className="h-[600px] bg-black"><SignalGlobe /></div>
*/
export type GlobeMarker = { lat: number; lng: number };
export type SignalGlobeProps = {
/** Locations to mark with beacons. Arcs run from the first marker to each of the others. */
markers?: GlobeMarker[];
/** Draw arcs between the markers. */
arcs?: boolean;
/** Colour of the dots at the centre of the disc. */
color?: string;
/** Colour the dots and the limb glow turn toward the edge. */
rim?: string;
/** Beacon and arc colour. */
accent?: string;
/** Turning speed multiplier. */
speed?: number;
/** Background colour. */
background?: string;
className?: string;
};
export const DEFAULT_MARKERS: GlobeMarker[] = [
{ lat: 51.5, lng: -0.12 },
{ lat: 40.7, lng: -74 },
{ lat: 35.7, lng: 139.7 },
{ lat: 1.35, lng: 103.8 },
{ lat: -23.5, lng: -46.6 },
{ lat: 37.77, lng: -122.4 },
{ lat: 19.1, lng: 72.9 },
{ lat: -33.9, lng: 151.2 },
];
// Natural Earth land (public domain), 720 x 360 equirectangular, rows run-length encoded as varints
const LAND = "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";
const MW = 720, MH = 360;
function decodeLand() {
const bin = atob(LAND);
const mask = new Uint8Array(MW * MH);
let p = 0;
for (let y = 0; y < MH; y++) {
let x = 0, v = 0;
while (x < MW) {
let n = 0, s = 0, b = 0;
do {
b = bin.charCodeAt(p++);
n |= (b & 0x7f) << s;
s += 7;
} while (b & 0x80);
if (v) mask.fill(255, y * MW + x, y * MW + x + n);
x += n;
v ^= 1;
}
}
return mask;
}
const reduced = () => typeof window !== "undefined" && window.matchMedia("(prefers-reduced-motion: reduce)").matches;
const toVec = (lat: number, lng: number, r = 1) => {
const la = THREE.MathUtils.degToRad(lat), lo = THREE.MathUtils.degToRad(lng);
return new THREE.Vector3(Math.cos(la) * Math.sin(lo) * r, Math.sin(la) * r, Math.cos(la) * Math.cos(lo) * r);
};
export function SignalGlobe({ markers = DEFAULT_MARKERS, arcs = true, color = "#c4c2ff", rim = "#9ff7cf", accent = "#7cf3ff", speed = 1, background = "#000000", className }: SignalGlobeProps) {
const rootRef = useRef<HTMLDivElement>(null);
const live = useRef({ color, rim, accent, speed });
live.current = { color, rim, accent, speed };
const markerKey = JSON.stringify(markers) + arcs;
useEffect(() => {
const root = rootRef.current;
if (!root) return;
const still = reduced();
const canvas = document.createElement("canvas");
canvas.style.cssText = "position:absolute;inset:0;width:100%;height:100%;display:block;";
root.appendChild(canvas);
let renderer: THREE.WebGLRenderer;
try {
renderer = new THREE.WebGLRenderer({ canvas, antialias: false, alpha: false, powerPreference: "high-performance" });
} catch {
canvas.remove();
return;
}
const dpr = Math.min(2, Math.max(1.5, window.devicePixelRatio || 1)); // supersampled: fine dots stay steady
renderer.setPixelRatio(dpr);
renderer.setClearColor(new THREE.Color(background), 1);
const scene = new THREE.Scene();
const camera = new THREE.PerspectiveCamera(28, 1, 0.1, 50);
const tiltRoot = new THREE.Group(); // axial tilt + cursor tilt
const globe = new THREE.Group(); // the spin
tiltRoot.add(globe);
scene.add(tiltRoot);
const mask = decodeLand();
const land = (lat: number, lng: number) => {
const x = Math.min(MW - 1, Math.max(0, Math.floor(((lng + 180) / 360) * MW)));
const y = Math.min(MH - 1, Math.max(0, Math.floor(((90 - lat) / 180) * MH)));
return mask[y * MW + x] > 0;
};
// ---- the dots: rows along the latitudes, evenly spaced along each row ----
const STEP = 0.9; // degrees between rows and between dots
const dotPos: number[] = [], seed: number[] = [];
for (let lat = -90 + STEP / 2; lat < 90; lat += STEP) {
const n = Math.max(1, Math.round((360 * Math.cos(THREE.MathUtils.degToRad(lat))) / STEP));
for (let i = 0; i < n; i++) {
const lng = -180 + (i + 0.5) * (360 / n);
if (!land(lat, lng)) continue;
const v = toVec(lat, lng);
dotPos.push(v.x, v.y, v.z);
seed.push(Math.random());
}
}
const dotGeo = new THREE.BufferGeometry();
dotGeo.setAttribute("position", new THREE.Float32BufferAttribute(dotPos, 3));
dotGeo.setAttribute("aSeed", new THREE.Float32BufferAttribute(seed, 1));
const U = {
uPx: { value: 1 },
uTime: { value: 0 },
uColor: { value: new THREE.Color(color) },
uRim: { value: new THREE.Color(rim) },
uHover: { value: new THREE.Vector3(0, 0, 1) },
uHoverAmt: { value: 0 },
uRipple: { value: new THREE.Vector3(0, 0, 1) },
uRippleT: { value: 9 },
};
const dotMat = new THREE.ShaderMaterial({
uniforms: U,
transparent: true,
depthWrite: false,
blending: THREE.AdditiveBlending,
vertexShader: `
uniform float uPx, uTime, uHoverAmt, uRippleT;
uniform vec3 uHover, uRipple, uColor, uRim;
attribute float aSeed;
varying vec3 vCol;
varying float vAlpha;
varying float vSize;
void main(){
vec3 n = normalize(position);
// the lens under the cursor, and the shock ripple from a click
float dh = acos(clamp(dot(n, uHover), -1.0, 1.0));
float lens = uHoverAmt * exp(-pow(dh / 0.24, 2.0));
float dr = acos(clamp(dot(n, uRipple), -1.0, 1.0));
float wave = exp(-pow((dr - uRippleT * 1.6) / 0.09, 2.0)) * exp(-uRippleT * 1.4);
vec3 p = n * (1.0 + lens * 0.085 + wave * 0.07);
vec4 mv = modelViewMatrix * vec4(p, 1.0);
gl_Position = projectionMatrix * mv;
vec3 vn = normalize(normalMatrix * n);
float facing = dot(vn, normalize(-mv.xyz));
float edge = pow(1.0 - clamp(facing, 0.0, 1.0), 1.6);
vCol = mix(uColor, uRim, smoothstep(0.2, 0.85, edge)) * (0.62 + 0.85 * edge) + vec3(1.0) * (lens * 0.8 + wave * 0.6) * smoothstep(0.0, 0.5, facing); // no glare where dots crowd at the limb
// fade in from the limb gradually: right at the edge the rows crowd into sub-pixel lines and
// would shimmer, so the soft rim glow underneath carries the brightness there instead
vAlpha = smoothstep(0.06, 0.4, facing);
// never draw a sprite under 2 device pixels (it pops and crawls as it moves between pixels):
// clamp the size and give the lost area back as transparency, so the energy stays constant
float size = uPx * (1.0 + lens * 0.9 + wave * 0.8) / -mv.z;
float s = max(size, 2.0);
vAlpha *= min(1.0, (size * size) / (s * s) * 1.15);
vSize = s;
gl_PointSize = s;
}`,
fragmentShader: `
varying vec3 vCol;
varying float vAlpha;
varying float vSize;
void main(){
// an analytically anti-aliased disc: the edge is exactly one pixel wide at any size
float d = length(gl_PointCoord - 0.5) * vSize;
float r = vSize * 0.5 - 0.5;
float a = clamp(r - d + 0.5, 0.0, 1.0) * vAlpha;
if (a < 0.004) discard;
gl_FragColor = vec4(vCol * a, a);
}`,
});
const dots = new THREE.Points(dotGeo, dotMat);
globe.add(dots);
// ---- the land underlay (a dim fill with lit coastlines) and the occluder that hides the far side ----
const maskTex = new THREE.DataTexture(mask, MW, MH, THREE.RedFormat);
maskTex.magFilter = THREE.LinearFilter;
maskTex.minFilter = THREE.LinearMipmapLinearFilter; // mipmapped: no shimmer where the map is squeezed at the limb
maskTex.generateMipmaps = true;
maskTex.anisotropy = 4;
maskTex.wrapS = THREE.RepeatWrapping;
maskTex.needsUpdate = true;
const sphereGeo = new THREE.SphereGeometry(0.996, 128, 96);
const occ = new THREE.Mesh(sphereGeo, new THREE.MeshBasicMaterial({ colorWrite: false }));
occ.renderOrder = -2;
globe.add(occ);
const underMat = new THREE.ShaderMaterial({
uniforms: { uMask: { value: maskTex }, uRim: U.uRim, uColor: U.uColor },
transparent: true,
depthWrite: false,
blending: THREE.AdditiveBlending,
vertexShader: `
varying vec3 vN; varying vec3 vV; varying vec3 vP;
void main(){
vP = normalize(position);
vec4 mv = modelViewMatrix * vec4(position, 1.0);
vN = normalize(normalMatrix * normal);
vV = normalize(-mv.xyz);
gl_Position = projectionMatrix * mv;
}`,
fragmentShader: `
uniform sampler2D uMask; uniform vec3 uRim, uColor;
varying vec3 vN; varying vec3 vV; varying vec3 vP;
void main(){
vec2 uv = vec2(atan(vP.x, vP.z) / 6.2831853 + 0.5, 0.5 - asin(clamp(vP.y, -1.0, 1.0)) / 3.1415927); // texture rows run north to south
float m = texture2D(uMask, uv).r;
float f = clamp(dot(vN, vV), 0.0, 1.0);
float edge = pow(1.0 - f, 3.0);
vec3 c = vec3(0.10, 0.12, 0.26) * m * 0.22; // a dim navy land fill
// the limb: a thin burning rim, brightest toward the light (upper right)
float lit = 0.55 + 0.45 * smoothstep(-0.6, 0.9, dot(vN, normalize(vec3(0.5, 0.6, 0.2))));
c += uRim * pow(1.0 - f, 4.0) * (0.05 + 0.8 * m) * lit; // the limb glows where land meets it, a whisper over the oceans
gl_FragColor = vec4(c, 1.0);
}`,
});
const under = new THREE.Mesh(sphereGeo, underMat);
under.renderOrder = -1;
globe.add(under);
// a soft atmosphere just outside the limb
const atmoMat = new THREE.ShaderMaterial({
uniforms: { uRim: U.uRim },
transparent: true,
depthWrite: false,
side: THREE.BackSide,
blending: THREE.AdditiveBlending,
vertexShader: "varying vec3 vN; varying vec3 vV;\nvoid main(){ vec4 mv = modelViewMatrix * vec4(position, 1.0); vN = normalize(normalMatrix * normal); vV = normalize(-mv.xyz); gl_Position = projectionMatrix * mv; }",
fragmentShader: "uniform vec3 uRim; varying vec3 vN; varying vec3 vV;\nvoid main(){ float f = clamp(dot(-vN, vV), 0.0, 1.0); float a = pow(f, 7.0) * 0.06; gl_FragColor = vec4(uRim * a, a); }",
});
const atmo = new THREE.Mesh(new THREE.SphereGeometry(1.09, 96, 64), atmoMat);
tiltRoot.add(atmo);
// ---- beacons and arcs ----
const accentU = { value: new THREE.Color(accent) };
const beaconGeo = new THREE.BufferGeometry();
const mk = markers.length ? markers : [];
beaconGeo.setAttribute("position", new THREE.Float32BufferAttribute(mk.flatMap((m) => toVec(m.lat, m.lng, 1.004).toArray()), 3));
beaconGeo.setAttribute("aSeed", new THREE.Float32BufferAttribute(mk.map((_, i) => i / Math.max(1, mk.length)), 1));
const beaconMat = new THREE.ShaderMaterial({
uniforms: { uPx: U.uPx, uTime: U.uTime, uAccent: accentU },
transparent: true,
depthWrite: false,
blending: THREE.AdditiveBlending,
vertexShader: `
uniform float uPx, uTime; attribute float aSeed; varying float vPh; varying float vA;
void main(){
vec4 mv = modelViewMatrix * vec4(position, 1.0);
gl_Position = projectionMatrix * mv;
vec3 vn = normalize(normalMatrix * normalize(position));
vA = smoothstep(0.0, 0.2, dot(vn, normalize(-mv.xyz)));
vPh = fract(uTime * 0.55 + aSeed);
gl_PointSize = uPx * 9.0 / -mv.z;
}`,
fragmentShader: `
uniform vec3 uAccent; varying float vPh; varying float vA;
void main(){
float d = length(gl_PointCoord - 0.5) * 2.0;
float core = smoothstep(0.16, 0.0, d);
float ring = smoothstep(0.06, 0.0, abs(d - vPh)) * (1.0 - vPh);
float a = (core * 1.6 + ring) * vA;
if (a < 0.01) discard;
gl_FragColor = vec4(uAccent * a, a);
}`,
});
const beacons = new THREE.Points(beaconGeo, beaconMat);
globe.add(beacons);
const arcMat = new THREE.ShaderMaterial({
uniforms: { uTime: U.uTime, uAccent: accentU },
transparent: true,
depthWrite: false,
blending: THREE.AdditiveBlending,
vertexShader: "attribute float aT; attribute float aSeed; varying float vT; varying float vS;\nvoid main(){ vT = aT; vS = aSeed; gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0); }",
fragmentShader: `
uniform vec3 uAccent; uniform float uTime; varying float vT; varying float vS;
void main(){
float head = fract(uTime * 0.32 + vS);
float d = head - vT;
float trail = d >= 0.0 ? exp(-d * 9.0) : 0.0;
float a = 0.12 + trail * 0.95;
gl_FragColor = vec4(uAccent * a, a);
}`,
});
const arcGeos: THREE.BufferGeometry[] = [];
if (arcs && mk.length > 1) {
const hub = toVec(mk[0].lat, mk[0].lng);
mk.slice(1).forEach((m, k) => {
const to = toVec(m.lat, m.lng);
const ang = hub.angleTo(to);
const pts: number[] = [], ts: number[] = [], ss: number[] = [];
const N = 96;
for (let i = 0; i <= N; i++) {
const t = i / N;
// slerp along the great circle, lifted into an arc
const v = new THREE.Vector3().copy(hub).lerp(to, t).normalize();
const sinA = Math.sin(ang);
if (sinA > 1e-4) {
v.copy(hub).multiplyScalar(Math.sin((1 - t) * ang) / sinA).add(to.clone().multiplyScalar(Math.sin(t * ang) / sinA));
}
v.multiplyScalar(1.005 + Math.sin(Math.PI * t) * (0.06 + ang * 0.12));
pts.push(v.x, v.y, v.z);
ts.push(t);
ss.push(k * 0.27);
}
const g = new THREE.BufferGeometry();
g.setAttribute("position", new THREE.Float32BufferAttribute(pts, 3));
g.setAttribute("aT", new THREE.Float32BufferAttribute(ts, 1));
g.setAttribute("aSeed", new THREE.Float32BufferAttribute(ss, 1));
arcGeos.push(g);
globe.add(new THREE.Line(g, arcMat));
});
}
// ---- post: a soft bloom on the bright limb and beacons ----
const composer = new EffectComposer(renderer, new THREE.WebGLRenderTarget(4, 4, { type: THREE.HalfFloatType, samples: 4 }));
composer.addPass(new RenderPass(scene, camera));
const bloom = new UnrealBloomPass(new THREE.Vector2(4, 4), 0.32, 0.3, 0.5);
(bloom.highPassUniforms as Record<string, THREE.IUniform>).smoothWidth.value = 0.45; // a soft knee: dots ease into the glow, they never pop
composer.addPass(bloom);
composer.addPass(new OutputPass());
let W = 0, H = 0;
const resize = () => {
const w = root.clientWidth, h = root.clientHeight;
if (w < 2 || h < 2 || (w === W && h === H)) return;
W = w;
H = h;
renderer.setSize(W, H, false);
composer.setPixelRatio(dpr);
composer.setSize(W, H);
camera.aspect = W / H;
const t = Math.tan(THREE.MathUtils.degToRad(14));
const z = Math.max(2.5 / (2 * t), 2.5 / (2 * t * camera.aspect));
camera.position.set(0, 0, z);
camera.lookAt(0, 0, 0);
camera.updateProjectionMatrix();
// dot size in device pixels (scaled by 1 / depth in the shader): about half the dot spacing
const pxPerUnit = (H * dpr) / (2 * t);
U.uPx.value = pxPerUnit * THREE.MathUtils.degToRad(STEP) * 0.44;
};
resize();
const ro = new ResizeObserver(resize);
ro.observe(root);
// ---- motion ----
type Sp = { x: number; v: number; t: number };
const step = (s: Sp, k: number, c: number, dt: number) => {
const h = dt / 2;
for (let i = 0; i < 2; i++) {
s.v += (k * (s.t - s.x) - c * s.v) * h;
s.x += s.v * h;
}
};
let yaw = 0.35, yawV = 0;
const pitch: Sp = { x: 0.1, v: 0, t: 0.1 };
const tiltX: Sp = { x: 0, v: 0, t: 0 }, tiltY: Sp = { x: 0, v: 0, t: 0 };
const squash: Sp = { x: 0, v: 0, t: 0 };
const hoverAmt: Sp = { x: 0, v: 0, t: 0 };
const hoverDir = new THREE.Vector3(0, 0, 1);
let t = 0;
let pointer: { x: number; y: number } | null = null;
let drag: { x: number; y: number; t: number; sx: number; sy: number; t0: number; id: number } | null = null;
const ray = new THREE.Raycaster();
const ndc = new THREE.Vector2();
const hitSphere = new THREE.Sphere(new THREE.Vector3(), 1);
const hp = new THREE.Vector3();
const inv = new THREE.Matrix4();
const pick = (px: number, py: number) => {
ndc.set((px / W) * 2 - 1, -(py / H) * 2 + 1);
ray.setFromCamera(ndc, camera);
if (!ray.ray.intersectSphere(hitSphere, hp)) return null;
inv.copy(globe.matrixWorld).invert();
return hp.clone().applyMatrix4(inv).normalize(); // in the globe's own space
};
const shock = (px: number, py: number) => {
if (still) return;
const p = pick(px, py);
if (p) U.uRipple.value.copy(p);
else U.uRipple.value.set(0, 0, 1).applyMatrix4(inv.copy(globe.matrixWorld).invert()).normalize();
U.uRippleT.value = 0;
squash.v -= 2.4;
};
let visible = true;
const io = new IntersectionObserver(([e]) => (visible = e.isIntersecting), { rootMargin: "80px" });
io.observe(root);
const tick = (_time: number, dms: number) => {
const dt = Math.min(0.05, Math.max(0.001, dms / 1000));
t += dt;
const L = live.current;
U.uTime.value = still ? 0 : t;
U.uColor.value.set(L.color);
U.uRim.value.set(L.rim);
accentU.value.set(L.accent);
// spin: its own slow turn, plus whatever a drag threw at it, coasting out
if (!drag) {
yawV *= Math.exp(-dt * 0.9);
yaw += ((still ? 0 : 0.22 * L.speed) + yawV) * dt;
step(pitch, 14, 5.5, dt);
}
const px = pointer ? (pointer.x / W) * 2 - 1 : 0;
const py = pointer ? -((pointer.y / H) * 2 - 1) : 0;
tiltX.t = still ? 0 : -py * 0.12;
tiltY.t = still ? 0 : px * 0.16;
step(tiltX, 22, 7, dt);
step(tiltY, 22, 7, dt);
tiltRoot.rotation.set(pitch.x + tiltX.x, tiltY.x, 0.18);
globe.rotation.y = yaw;
step(squash, 170, 10, dt);
const s = 1 + squash.x * 0.035;
globe.scale.set(s, 2 - s, s);
tiltRoot.updateMatrixWorld(true);
// the lens follows the cursor across the surface
const hd = pointer && !drag && !still ? pick(pointer.x, pointer.y) : null;
hoverAmt.t = hd ? 1 : 0;
if (hd) hoverDir.lerp(hd, 1 - Math.exp(-dt * 18)).normalize();
step(hoverAmt, 60, 12, dt);
U.uHover.value.copy(hoverDir);
U.uHoverAmt.value = Math.max(0, hoverAmt.x);
if (U.uRippleT.value < 9) U.uRippleT.value += dt;
if (visible && W) composer.render(dt);
};
gsap.ticker.add(tick);
// ---- input ----
const pos = (e: PointerEvent) => {
const r = root.getBoundingClientRect();
return { x: e.clientX - r.left, y: e.clientY - r.top };
};
const onMove = (e: PointerEvent) => {
pointer = pos(e);
if (!drag) return;
const now = performance.now();
const dx = e.clientX - drag.x, dy = e.clientY - drag.y;
const ddt = Math.max(8, now - drag.t) / 1000;
const k = 3.2 / Math.max(260, Math.min(W, H));
yaw += dx * k;
yawV = THREE.MathUtils.lerp(yawV, (dx * k) / ddt, 0.5);
pitch.x = THREE.MathUtils.clamp(pitch.x + dy * k, -0.6, 1.1);
drag.x = e.clientX;
drag.y = e.clientY;
drag.t = now;
};
const onDown = (e: PointerEvent) => {
if (e.button !== 0) return;
const now = performance.now();
drag = { x: e.clientX, y: e.clientY, t: now, sx: e.clientX, sy: e.clientY, t0: now, id: e.pointerId };
yawV = 0;
try {
root.setPointerCapture(e.pointerId);
} catch {
/* synthetic pointers can't be captured */
}
};
const onUp = (e: PointerEvent) => {
if (!drag) return;
const moved = Math.hypot(e.clientX - drag.sx, e.clientY - drag.sy);
const quick = performance.now() - drag.t0 < 450;
try {
root.releasePointerCapture(drag.id);
} catch {
/* not captured */
}
if (performance.now() - drag.t > 90) yawV = 0;
drag = null;
pitch.v = 0;
if (moved < 7 && quick) {
yawV = 0;
const p = pos(e);
shock(p.x, p.y);
}
};
const onLeave = () => {
if (!drag) pointer = null;
};
const onKey = (e: KeyboardEvent) => {
if (e.key === "Enter" || e.key === " ") {
e.preventDefault();
shock(W / 2, H / 2);
}
};
root.addEventListener("pointermove", onMove);
root.addEventListener("pointerdown", onDown);
root.addEventListener("pointerup", onUp);
root.addEventListener("pointercancel", onUp);
root.addEventListener("pointerleave", onLeave);
root.addEventListener("keydown", onKey);
return () => {
gsap.ticker.remove(tick);
io.disconnect();
ro.disconnect();
root.removeEventListener("pointermove", onMove);
root.removeEventListener("pointerdown", onDown);
root.removeEventListener("pointerup", onUp);
root.removeEventListener("pointercancel", onUp);
root.removeEventListener("pointerleave", onLeave);
root.removeEventListener("keydown", onKey);
[dotGeo, sphereGeo, beaconGeo, atmo.geometry, ...arcGeos].forEach((g) => g.dispose());
[dotMat, underMat, atmoMat, beaconMat, arcMat, occ.material as THREE.Material].forEach((m) => m.dispose());
maskTex.dispose();
composer.dispose();
renderer.dispose();
canvas.remove();
};
}, [markerKey, background]); // eslint-disable-line react-hooks/exhaustive-deps
return (
<div
ref={rootRef}
tabIndex={0}
role="button"
aria-label="A dotted globe with location beacons. Drag to spin it, press Enter to send a ripple."
className={["relative h-full min-h-[260px] w-full cursor-grab touch-none overflow-hidden outline-none select-none active:cursor-grabbing", className].filter(Boolean).join(" ")}
style={{ background }}
/>
);
}
export default SignalGlobe;
One prompt, any AI agent
Paste into Claude Code, Codex, Cursor or Windsurf. It carries your tweaks and the full source, so the agent installs it exactly.
Props
8 propsmarkers{ lat: number; lng: number }[]Locations to mark with beacons. Arcs run from the first to each of the others.default eight world citiesdefault eight world citiesarcsbooleanDraw arcs between the markers.default truedefault truecolorstringColour of the dots at the centre of the disc.default "#c4c2ff"default "#c4c2ff"rimstringColour the dots and the limb glow turn toward the edge.default "#9ff7cf"default "#9ff7cf"accentstringBeacon and arc colour.default "#7cf3ff"default "#7cf3ff"speednumberTurning speed multiplier.default 1default 1backgroundstringBackground colour.default "#000000"default "#000000"classNamestringExtra classes (it fills its parent).