Animations113 / 118
Glyph Globe
The Earth drawn as a grid of pixel-art tiles: sparkles on the oceans, rings on the coasts, striped tiles on land and magenta on the cold north. The grid stays still while the planet turns beneath it, so every tile flips as it moves. A lens magnifies the map under your cursor; drag to spin, click to send a decode wave.
three.jsthree.jsGlobeGlobePixel artPixel artRender targetRender targetSpringsSpringsGSAPGSAP
Hover to magnify, drag to spinClick to send a decode wave
Tweak
LIVELIVETiles
15px
#4fae96
#93c7a2
#ef4fd6
#f3f0c8
Motion
1.0×
Usage
Follows your tweaks.
usage.tsx
import { GlyphGlobe } from "@/components/inreact/glyph-globe";
export function Hero() {
return (
<section className="h-[600px] bg-black">
<GlyphGlobe cell={15} ocean="#4fae96" land="#93c7a2" accent="#ef4fd6" ink="#f3f0c8" speed={1} />
</section>
);
}Install with the CLI
TS + Tailwind
npx shadcn@latest add https://inreact.vercel.app/r/glyph-globe.jsonOr copy the source
Install the dependencies, then save this as components/inreact/glyph-globe.tsx.
terminal
npm install gsap threecomponents/inreact/glyph-globe.tsx
"use client";
import { gsap } from "gsap";
import { useEffect, useRef } from "react";
import * as THREE from "three";
/**
* Glyph Globe: the Earth drawn as a grid of pixel-art tiles, rendered live in three.js. The grid
* stays fixed to the screen while the planet turns beneath it, so every tile flips to whatever lies
* under it now: sparkles on open ocean, rings on coastal water, striped tiles on land, crosses on
* arid interiors, dotted tiles here and there, and magenta tiles on cold, high-latitude land. Real
* coastlines are baked into this file, so nothing loads.
*
* - A lens follows your cursor and magnifies the map beneath it, tile by tile.
* - Drag to spin it; it coasts like a body in space and eases back to its own slow turn.
* - Click (or Enter / Space): a decode wave runs out from your click, scrambling the tiles and
* resolving them back to the map.
*
* <div className="h-[600px] bg-black"><GlyphGlobe /></div>
*/
export type GlyphGlobeProps = {
/** Size of each tile in CSS pixels on a ~560px tall stage, 8 to 24 (it scales with the stage). */
cell?: number;
/** Ocean sparkle colour. */
ocean?: string;
/** Land tile colour. */
land?: string;
/** Colour of the cold, high-latitude tiles. */
accent?: string;
/** Colour of the rings and crosses. */
ink?: string;
/** Turning speed multiplier. */
speed?: number;
/** Background colour. */
background?: string;
className?: string;
};
// 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(1, y * MW + x, y * MW + x + n);
x += n;
v ^= 1;
}
}
return mask;
}
// tile classes (0 = nothing)
const OCEAN = 1, SHORE = 2, LANDC = 3, ARID = 4, DOTTED = 5, COLD = 6;
const KINDS = 6;
// one degree class map: what kind of tile each patch of the Earth shows
function classMap() {
const m = decodeLand();
const W = 360, H = 180;
const land = new Uint8Array(W * H);
for (let y = 0; y < H; y++)
for (let x = 0; x < W; x++) {
let s = 0;
for (let j = 0; j < 2; j++) for (let i = 0; i < 2; i++) s += m[(y * 2 + j) * MW + x * 2 + i];
land[y * W + x] = s >= 2 ? 1 : 0;
}
// distance (in cells, 8-connected, wrapping east-west) to the other medium
const dist = (target: number) => {
const d = new Int16Array(W * H).fill(999);
const q: number[] = [];
for (let i = 0; i < W * H; i++) if (land[i] === target) { d[i] = 0; q.push(i); }
for (let h = 0; h < q.length; h++) {
const i = q[h], x = i % W, y = (i / W) | 0;
for (let dy = -1; dy <= 1; dy++)
for (let dx = -1; dx <= 1; dx++) {
const ny = y + dy;
if (ny < 0 || ny >= H) continue;
const j = ny * W + ((x + dx + W) % W);
if (d[j] > d[i] + 1) { d[j] = d[i] + 1; q.push(j); }
}
}
return d;
};
const toOcean = dist(0), toLand = dist(1);
const out = new Uint8Array(W * H);
for (let y = 0; y < H; y++) {
const lat = 89.5 - y;
for (let x = 0; x < W; x++) {
const i = y * W + x;
const h = Math.sin(x * 12.9898 + y * 78.233) * 43758.5453;
const r = h - Math.floor(h);
let k: number;
if (land[i]) {
if (Math.abs(lat) >= 52) k = COLD;
else if (Math.abs(lat) >= 14 && Math.abs(lat) <= 34 && toOcean[i] >= 3) k = r < 0.85 ? ARID : DOTTED;
else k = r < 0.12 && toOcean[i] >= 2 ? DOTTED : LANDC;
} else k = toLand[i] <= 3 ? SHORE : OCEAN;
out[i] = Math.round((k / 8) * 255);
}
}
return { data: out, W, H };
}
// the tile atlas: one glyph per class, drawn crisp on a canvas
function drawAtlas(ctx: CanvasRenderingContext2D, S: number, c: { ocean: string; land: string; accent: string; ink: string }) {
ctx.clearRect(0, 0, S * KINDS, S);
const at = (k: number) => (k - 1) * S;
ctx.lineCap = "butt";
// ocean: a four-point sparkle
{
const x = at(OCEAN) + S / 2, y = S / 2, a = S * 0.44, b = S * 0.035;
ctx.fillStyle = c.ocean;
ctx.beginPath();
ctx.moveTo(x, y - a);
ctx.quadraticCurveTo(x + b, y - b, x + a, y);
ctx.quadraticCurveTo(x + b, y + b, x, y + a);
ctx.quadraticCurveTo(x - b, y + b, x - a, y);
ctx.quadraticCurveTo(x - b, y - b, x, y - a);
ctx.fill();
}
// shore: a hollow ring, lighter than the ink so it reads white on the dark sea
ctx.strokeStyle = "rgba(236,238,232,1)";
ctx.lineWidth = S * 0.105;
ctx.beginPath();
ctx.arc(at(SHORE) + S / 2, S / 2, S * 0.39, 0, Math.PI * 2);
ctx.stroke();
// land: a striped tile
{
const x0 = at(LANDC) + S * 0.06, w = S * 0.88;
ctx.fillStyle = c.land;
for (let i = 0; i < 4; i++) ctx.fillRect(x0 + (i * w) / 4 + S * 0.02, S * 0.06, w / 4 - S * 0.06, S * 0.88);
}
// arid: a bold cross
{
const x = at(ARID) + S / 2, y = S / 2, t = S * 0.2, l = S * 0.42;
ctx.fillStyle = c.ink;
ctx.fillRect(x - t / 2, y - l, t, l * 2);
ctx.fillRect(x - l, y - t / 2, l * 2, t);
}
// dotted: a dark tile with a lit dot
{
const x0 = at(DOTTED);
ctx.fillStyle = "rgba(40,58,46,1)";
ctx.fillRect(x0 + S * 0.06, S * 0.06, S * 0.88, S * 0.88);
ctx.fillStyle = c.land;
ctx.beginPath();
ctx.arc(x0 + S / 2, S / 2, S * 0.12, 0, Math.PI * 2);
ctx.fill();
}
// cold: a filled disc crossed out
{
const x = at(COLD) + S / 2, y = S / 2, r = S * 0.42;
ctx.fillStyle = c.accent;
ctx.beginPath();
ctx.arc(x, y, r, 0, Math.PI * 2);
ctx.fill();
ctx.strokeStyle = "rgba(255,255,255,0.95)";
ctx.lineWidth = S * 0.08;
const e = r * 0.62;
ctx.beginPath();
ctx.moveTo(x - e, y - e);
ctx.lineTo(x + e, y + e);
ctx.moveTo(x + e, y - e);
ctx.lineTo(x - e, y + e);
ctx.stroke();
}
}
const reduced = () => typeof window !== "undefined" && window.matchMedia("(prefers-reduced-motion: reduce)").matches;
export function GlyphGlobe({ cell = 15, ocean = "#4fae96", land = "#93c7a2", accent = "#ef4fd6", ink = "#f3f0c8", speed = 1, background = "#000000", className }: GlyphGlobeProps) {
const rootRef = useRef<HTMLDivElement>(null);
const live = useRef({ cell, ocean, land, accent, ink, speed });
live.current = { cell, ocean, land, accent, ink, speed };
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, window.devicePixelRatio || 1));
renderer.setPixelRatio(dpr);
renderer.setClearColor(new THREE.Color(background), 1);
// ---- pass 1: the globe, rendered as tile classes into a small target ----
const cm = classMap();
const clsTex = new THREE.DataTexture(cm.data, cm.W, cm.H, THREE.RedFormat);
clsTex.magFilter = clsTex.minFilter = THREE.NearestFilter;
clsTex.needsUpdate = true;
const globeScene = new THREE.Scene();
const camera = new THREE.PerspectiveCamera(22, 1, 0.1, 50);
const tilt = new THREE.Group();
const spin = new THREE.Group();
tilt.add(spin);
globeScene.add(tilt);
const sphereGeo = new THREE.SphereGeometry(1, 128, 96);
const sphereMat = new THREE.ShaderMaterial({
uniforms: { uCls: { value: clsTex } },
vertexShader: "varying vec3 vP;\nvoid main(){ vP = normalize(position); gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0); }",
fragmentShader: `
uniform sampler2D uCls; 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);
gl_FragColor = vec4(texture2D(uCls, uv).r, 0.0, 0.0, 1.0);
}`,
});
spin.add(new THREE.Mesh(sphereGeo, sphereMat));
const clsRT = new THREE.WebGLRenderTarget(4, 4, { minFilter: THREE.NearestFilter, magFilter: THREE.NearestFilter, depthBuffer: true });
// ---- pass 2: one glyph per screen cell ----
const S = 96;
const atlasC = document.createElement("canvas");
atlasC.width = S * KINDS;
atlasC.height = S;
const actx = atlasC.getContext("2d")!;
const atlas = new THREE.CanvasTexture(atlasC);
atlas.colorSpace = THREE.NoColorSpace;
atlas.premultiplyAlpha = true; // clean edges when the glyphs are minified
atlas.minFilter = THREE.LinearMipmapLinearFilter;
atlas.generateMipmaps = true;
atlas.anisotropy = 4;
let atlasKey = "";
const U = {
uCls: { value: clsRT.texture },
uAtlas: { value: atlas },
uRes: { value: new THREE.Vector2(1, 1) },
uCell: { value: 26 },
uMouse: { value: new THREE.Vector2(-9999, -9999) },
uLens: { value: 0 },
uWave: { value: new THREE.Vector2(0, 0) },
uWaveT: { value: 9 },
uTick: { value: 0 },
};
const glyphMat = new THREE.ShaderMaterial({
uniforms: U,
transparent: true,
premultipliedAlpha: true,
depthTest: false,
vertexShader: "void main(){ gl_Position = vec4(position.xy, 0.0, 1.0); }",
fragmentShader: `
uniform sampler2D uCls, uAtlas;
uniform vec2 uRes, uMouse, uWave;
uniform float uCell, uLens, uWaveT, uTick;
float h21(vec2 p){ return fract(sin(dot(p, vec2(12.9898, 78.233))) * 43758.5453); }
void main(){
vec2 fc = gl_FragCoord.xy;
vec2 cell = floor(fc / uCell);
vec2 ctr = (cell + 0.5) * uCell;
vec2 local = (fc - cell * uCell) / uCell;
// the lens: cells near the cursor read the map closer in, so it magnifies tile by tile
vec2 d = ctr - uMouse;
float R = uCell * 7.5;
float k = uLens * (1.0 - smoothstep(R * 0.35, R, length(d)));
vec2 sp = uMouse + d * (1.0 - 0.5 * k);
float cls = floor(texture2D(uCls, sp / uRes).r * 8.0 + 0.5);
if (cls < 0.5) discard;
// the decode wave: a ring of scrambled tiles running out from a click
float wd = length(ctr - uWave) / uCell;
float front = uWaveT * 32.0;
float band = (1.0 - smoothstep(0.0, 3.0, abs(wd - front))) * (1.0 - smoothstep(0.6, 1.1, uWaveT));
float scr = h21(cell + uTick);
if (scr < band * 0.9) cls = 1.0 + floor(h21(cell * 1.7 + uTick) * 6.0);
// tiles inside the lens grow a little and brighten
float grow = 1.0 + k * 0.08;
vec2 g = (local - 0.5) / grow + 0.5;
if (g.x < 0.0 || g.x > 1.0 || g.y < 0.0 || g.y > 1.0) discard;
vec4 a = texture2D(uAtlas, vec2((cls - 1.0 + g.x) / 6.0, g.y)); // canvas textures are flipped: v = 1 is the top
a.rgb *= 1.0 + k * 0.35 + band * 0.4; // (premultiplied: brightening keeps the edges clean)
if (a.a < 0.01) discard;
gl_FragColor = a;
}`,
});
const quadScene = new THREE.Scene();
const quadGeo = new THREE.BufferGeometry();
quadGeo.setAttribute("position", new THREE.Float32BufferAttribute([-1, -1, 0, 3, -1, 0, -1, 3, 0], 3));
const quad = new THREE.Mesh(quadGeo, glyphMat);
quad.frustumCulled = false;
quadScene.add(quad);
const quadCam = new THREE.OrthographicCamera(-1, 1, 1, -1, 0, 1);
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);
const pw = Math.round(W * dpr), ph = Math.round(H * dpr);
clsRT.setSize(Math.ceil(pw / 2), Math.ceil(ph / 2));
U.uRes.value.set(pw, ph);
camera.aspect = W / H;
const t = Math.tan(THREE.MathUtils.degToRad(11));
camera.position.set(0, 0, Math.max(2.45 / (2 * t), 2.45 / (2 * t * camera.aspect)));
camera.lookAt(0, 0, 0);
camera.updateProjectionMatrix();
};
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 = 2.0, yawV = 0;
const pitch: Sp = { x: 0.38, v: 0, t: 0.38 };
const tiltY: Sp = { x: 0, v: 0, t: 0 };
const lens: Sp = { x: 0, v: 0, t: 0 };
const mouse = new THREE.Vector2(-9999, -9999);
let t = 0, tickT = 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 wave = (x: number, y: number) => {
if (still) return;
U.uWave.value.set(x * dpr, (H - y) * dpr);
U.uWaveT.value = 0;
yawV += 0.9; // a little kick
};
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;
const key = [L.ocean, L.land, L.accent, L.ink].join();
if (key !== atlasKey) {
atlasKey = key;
drawAtlas(actx, S, L);
atlas.needsUpdate = true;
}
// tiles scale with the stage (the cell prop is for a ~560px tall stage), so small cards still read as a globe
const fit = THREE.MathUtils.clamp(Math.min(W, H) / 560, 0.5, 1.4);
U.uCell.value = Math.max(5, Math.round(THREE.MathUtils.clamp(L.cell, 8, 24) * fit * dpr));
if (!drag) {
yawV *= Math.exp(-dt * 1.0);
yaw += ((still ? 0 : 0.28 * L.speed) + yawV) * dt;
step(pitch, 12, 5, dt);
}
const px = pointer ? (pointer.x / W) * 2 - 1 : 0;
tiltY.t = still ? 0 : px * 0.12;
step(tiltY, 20, 7, dt);
tilt.rotation.set(pitch.x, tiltY.x, 0.12);
spin.rotation.y = yaw;
// the lens glides after the cursor
lens.t = pointer && !drag && !still ? 1 : 0;
step(lens, 40, 10, dt);
if (pointer) {
const tx = pointer.x * dpr, ty = (H - pointer.y) * dpr;
if (mouse.x < -9000) mouse.set(tx, ty);
mouse.x += (tx - mouse.x) * (1 - Math.exp(-dt * 16));
mouse.y += (ty - mouse.y) * (1 - Math.exp(-dt * 16));
}
U.uMouse.value.copy(mouse);
U.uLens.value = Math.max(0, lens.x);
if (U.uWaveT.value < 9) U.uWaveT.value += dt;
// the scramble re-rolls about 12 times a second: a decode, not a strobe
tickT += dt;
if (tickT > 1 / 12) {
tickT = 0;
U.uTick.value = (U.uTick.value + 1) % 997;
}
if (visible && W) {
renderer.setRenderTarget(clsRT);
renderer.setClearColor(0x000000, 0);
renderer.clear();
renderer.render(globeScene, camera);
renderer.setRenderTarget(null);
renderer.setClearColor(new THREE.Color(background), 1);
renderer.clear();
renderer.render(quadScene, quadCam);
}
};
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.0 / 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.7, 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);
wave(p.x, p.y);
}
};
const onLeave = () => {
if (!drag) pointer = null;
};
const onKey = (e: KeyboardEvent) => {
if (e.key === "Enter" || e.key === " ") {
e.preventDefault();
wave(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);
[sphereGeo, quadGeo].forEach((g) => g.dispose());
[sphereMat, glyphMat].forEach((m) => m.dispose());
[clsTex, atlas].forEach((x) => x.dispose());
clsRT.dispose();
renderer.dispose();
canvas.remove();
};
}, [background]);
return (
<div
ref={rootRef}
tabIndex={0}
role="button"
aria-label="A globe drawn in pixel tiles. Drag to spin it, press Enter to send a decode wave."
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 GlyphGlobe;
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 propscellnumberSize of each tile in CSS pixels, 8 to 24.default 15default 15oceanstringOcean sparkle colour.default "#4fae96"default "#4fae96"landstringLand tile colour.default "#93c7a2"default "#93c7a2"accentstringColour of the cold, high-latitude tiles.default "#ef4fd6"default "#ef4fd6"inkstringColour of the rings and crosses.default "#f3f0c8"default "#f3f0c8"speednumberTurning speed multiplier.default 1default 1backgroundstringBackground colour.default "#000000"default "#000000"classNamestringExtra classes (it fills its parent).