AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

globestudio

Creates, edits and embeds dotted world maps and animated 3D globes with Globestudio (globestudio.app), a free open source studio with 21 looks. Use when the user wants a dotted map, a dotted or 3D globe, a spinning earth or a stylized world map for a website hero, background, slide, social post or video; when they paste a globestudio.app link or a ?c= config; or when code uses @globestudio/react, @globestudio/element, the globe-studio web component or globestudio.app/embed. Also use it to highlight a country, continent or region, plot points and arcs, match brand colors, or prepare PNG, SVG, GLB, MP4, WebM or GIF exports. Not for interactive tiled maps, routing, geocoding or GIS analysis (Mapbox, MapLibre, deck.gl), or for ordinary charts.

Original source
github
License
MIT
Pinned revision
5269f7ea2d6c3a9bfda5ed878b6726cf509121fd

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

Ask your assistant

Use Agentic Memory skills to read github--globestudio at revision 5269f7ea2d6c3a9bfda5ed878b6726cf509121fd, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 4

references/config.md

Globestudio config reference

Generated by scripts/generate-skill-references.js from public/schema/config.json, src/config/*.js, src/data/look-presets.js, src/data/geography.js, src/data/us-state-codes.js and src/utils/embed-snippets.js. Edits made here by hand are lost the next time it is generated.

Every key the app keeps from a config, with what it takes. The schema at https://globestudio.app/schema/config.json says the same, and a test holds it equal to the parser (normalizeConfig in src/utils/share-config.js) that every link, embed and import goes through. The parser drops any other key or value without a word and clamps numbers into their range.

Contents

  • Reading a config: links, versions and partial settings
  • Top-level keys
  • shaderSettings, and which knobs each effect reads
  • globeSettings, spaceSettings and flowSettings
  • Gradients
  • Custom shapes
  • Shapes
  • Regions: continents, subregions, countries the map can't draw, US states
  • Limits

Reading a config

  • A link carries the config as ?c= plus encodeURIComponent(JSON.stringify(config)). "v": 3 in the JSON marks that it was encoded once and that its colors render as their hex. With "v": 2, or in older links without it, they render darker than their hex, as they always have. The app writes 3 for a design with a picked color and 2 for the rest.
  • On /looks/<id> and /embed?look=<id> the look comes first and the config changes only the keys it names. In shaderSettings, globeSettings, spaceSettings and flowSettings the keys a config leaves out keep the look's values.
  • In the studio a look sets only its styling: the region, the data points and any other key the look doesn't set keep what the person last used there, and the view opens as a globe. On / with no look every top-level key a config leaves out does, and the four nested objects fill their gaps with the app defaults below.
  • An embed draws the look as the studio does, its density, dot size, background and transparency included, and the address's parameters and the config change what they name. A background color in the address or the config keeps the page solid on a transparent look (Wireframe). With no look, an embed draws Default: density 40, dot size 10, on a near black page unless the address or the config sets a background.
  • A file imported in the export dialog's Share tab carries no look, so the four nested objects fill their gaps with the app defaults: a file must hold the whole design, as the studio's own exports do.
  • version: Written by the app in every exported file and share link, where it marks a whole design: in shaderSettings, globeSettings, spaceSettings and flowSettings, keys the config leaves out get the app defaults, even on a look. Leave it out of a config that changes only some settings of a look. 2 also says the dot, map, grid, network, marker and flow colors render as their hex: the app writes 2 once a color is picked, and 1 for a design whose colors render darker than their hex, as every color did before.
  • Default look is the value the Default look sets, where it sets one. App default is what a nested object falls back to with no look.

Top-level keys

| Key | Takes | Default look | Notes | |---|---|---|---| | selection | text such as world, country:USA, continent:Europe, subregion:Western Europe | "world" | What the map shows: world, country: and an uppercase ISO 3166-1 alpha-3 code, continent: and a continent name, or subregion: and a subregion name. A lowercase code is dropped, and a name the app doesn't know shows the world. | | stateSelection | all, a postal code or a FIPS code (see US states) | "all" | When selection is country:USA, the state, DC or territory to show, by its postal code (CA) or its 2 digit FIPS code (06), or all for the whole country. The app stores the FIPS code, the id us-atlas gives the state. Any other value is dropped. The studio and embeds both draw the state. | | background | hex color | "#0a0a0a" | Canvas color, as hex (# optional). | | transparent | true or false | false | See-through background in place of background. | | backgroundStyle | solid, space, flow, transparent | "solid" | solid paints a flat color; space paints a starfield-and-nebula scene; flow paints an animated gradient-mesh shader; transparent paints nothing and implies transparent: true. | | density | 1 to 100 | 40 | Dot density across the visible area. | | dotSize | 0.1 to 30 | 10 | Dot radius. | | dotColor | hex color | "#ffffff" | Dot color, as hex. | | dotColorAlpha | 0 to 1 | | Dot opacity. | | dotGradient | gradient or null (see Gradients) | | Gradient for the dots, used in place of dotColor. | | dotsVisible | true or false | true | | | shape | Circle, Hexagon, Triangle, Pentagon, Square, Voxel, Particle Grid, Diamond, Star, Plus, Ring, ASCII, Custom | "Circle" | Dot shape. ASCII draws asciiSymbol and Custom draws customShape. | | dotRotation | 0 to 360 | | Rotation of every dot, in degrees. The studio reads it; embeds draw every dot unrotated. | | shapeRotationSpeed | 0 to 100 | | Shape rotation speed from 0 to 100 (0 stops the animation). | | sizeVary | true or false | | Add per-dot size jitter. | | asciiSymbol | text, up to 12 characters | "*" | Text drawn as each dot when shape is ASCII. Longer text is cut to 12 characters. | | customShape | object or null (see Custom shapes) | | The image drawn as each dot when shape is Custom, or null. An SVG is cleaned of scripts and event handlers before use. The file rides in the link, so one of more than a few dozen kB won't fit in an embed address, which must stay under 32,000 characters. | | renderMode | dots, solid | "dots" | dots draws the land as dots, solid as filled shapes. | | worldFill | hex color | "#5a5a64" | Land fill color in solid maps, as hex. | | worldFillAlpha | 0 to 1 | | | | worldFillGradient | gradient or null (see Gradients) | | Gradient for the land fill, used in place of worldFill. | | worldFillVisible | true or false | | | | worldStroke | hex color | "#f6f2ea" | Outline color in solid maps, as hex. | | worldStrokeAlpha | 0 to 1 | | | | worldStrokeGradient | gradient or null (see Gradients) | | Gradient for the outlines, used in place of worldStroke. | | worldStrokeVisible | true or false | | | | worldStrokeWidth | 0 to 10 | | | | mapDepth | 0 to 100 | 55 | FOV-style depth for the 3D map view. | | tiltX | -180 to 180 | 0 | | | tiltY | -180 to 180 | 0 | | | animationsEnabled | true or false | | false holds the design still. | | viewMode | globe, flat | | 3D globe or flat map. | | viewSwitch | true or false | | Embeds only: true shows a Globe and Map switch in a corner, so visitors can turn the globe into the flat map and back. The studio has its own switch and ignores this. | | flatProjection | mercator, equalEarth, naturalEarth1, winkel3, robinson | | Projection for the flat map view. It applies to solid maps (renderMode "solid"); dotted maps always use Mercator. | | riversVisible | true or false | | | | citiesVisible | true or false | | | | citiesMinPop | 0 to 50,000,000 | | Show only cities with at least this population. |

shaderSettings

The shader pass. effect picks it; the other keys are knobs, and each effect reads only some of them.

| Key | Takes | App default | Notes | |---|---|---|---| | effect | none, bloom, chromatic, crt, halftone, pixel, threshold, glitch, edge, wave, metal, pencil, toon, stripes, badtv, rgb, chroma, corrupt, bayer, iridescent, risograph, newsprint, aurora, atkinson, ascii | "none" | | | intensity | 0 to 100 | 45 | | | split | 0 to 100 | 7 | | | grain | 0 to 100 | 8 | | | scanlines | 0 to 100 | 36 | | | cellSize | 0 to 30 | 14 | | | threshold | 0 to 100 | 50 | | | warp | 0 to 100 | 24 | | | motion | 0 to 100 | 35 | |

Knobs each effect reads

Every effect reads intensity and grain; the others only where listed. none draws no shader pass. Dot color says what the effect does with dotColor and dotGradient.

| Effect | Label | Knobs | Dot color | |---|---|---|---| | none | None | | kept | | bloom | Bloom | intensity, split, warp, motion, grain | kept | | chromatic | Chromatic | intensity, split, warp, motion, grain | kept | | crt | CRT | intensity, split, cellSize, scanlines, warp, motion, grain | kept | | halftone | Halftone | intensity, cellSize, scanlines, motion, grain | ignored: white ink, graphite with theme=light | | pixel | Pixel | intensity, cellSize, scanlines, grain | kept | | threshold | Threshold | intensity, threshold, warp, motion, grain | ignored: white ink, graphite with theme=light | | glitch | Glitch | intensity, split, scanlines, motion, grain | kept | | edge | Edge | intensity, threshold, grain | ignored: white ink, graphite with theme=light | | wave | Wave | intensity, split, warp, motion, grain | kept | | metal | Metal | intensity, motion, grain | ignored: chrome | | pencil | Pencil | intensity, grain | ignored: graphite on paper | | toon | Toon | intensity, grain | ignored: white ink, graphite with theme=light | | stripes | Stripes | intensity, cellSize, motion, grain | kept | | badtv | Bad TV | intensity, motion, grain | kept | | rgb | RGB | intensity, motion, grain | kept | | chroma | Chroma | intensity, motion, grain | kept | | corrupt | Corrupt | intensity, cellSize, motion, grain | changed: snapped to pure RGB colors | | bayer | Bayer dither | intensity, cellSize, grain | kept | | iridescent | Iridescent | intensity, cellSize, motion, grain | changed: light colors turn to a shifting foil hue | | risograph | Risograph | intensity, split, cellSize, grain | changed: light colors turn to pink and cyan ink | | newsprint | Newsprint | intensity, cellSize, grain | ignored: a CMYK print on white paper | | aurora | Aurora | intensity, cellSize, motion, grain | changed: green, cyan and magenta bands over it | | atkinson | Atkinson dither | intensity, cellSize, grain | kept | | ascii | ASCII | intensity, cellSize, grain | ignored: white ink, graphite with theme=light |

globeSettings

3D globe chrome: auto-spin, glow halo, grid mesh, network arcs, data markers.

| Key | Takes | App default | Notes | |---|---|---|---| | look | classic, borderless | "classic" | | | autoSpin | true or false | true | Legacy field. The current control is autoSpinSpeed (0 to 100, where 0 stops the spin); when this is false on import, autoSpinSpeed is forced to 0. | | autoSpinSpeed | 0 to 100 | 35 | Globe auto-rotation speed from 0 to 100 (0 stops the spin). | | dotLift | 0 to 100 | 15 | How far the dots sit above the sphere. | | glow | true or false | true | | | glowStrength | 0 to 100 | 58 | | | glowSpread | 0 to 100 | 50 | | | glowColor | hex color or null | null | Hex color for the glow halo. null picks one from the look and the dot color. | | grid | true or false | true | | | gridColor | hex color | "#ffffff" | Solid tint for all grid lines unless gridGradient is set. | | gridGradient | gradient or null (see Gradients) | null | Gradient for the grid lines, by latitude (south → north). | | gridLift | 0 to 100 | 1 | How far the grid lines sit above the sphere. | | gridSize | 5 to 90 | 30 | Degrees between grid lines. | | gridStrength | 0 to 100 | 45 | | | network | true or false | true | City pulses + great-circle route arcs. | | networkStrength | 0 to 100 | 70 | | | networkArcs | 0 to 100, or true or false | 60 | Arc density from 0 to 100, or legacy bool (true = default density, false = hidden). | | networkPulses | 0 to 100, or true or false | 50 | Pulse density from 0 to 100, or legacy bool (true = default density, false = hidden). | | arcColor | hex color or null | null | Hex string. Uniform tint for all network arc lines/trails/heads. null falls back to per-route hardcoded polychrome. | | pulseColor | hex color or null | null | Hex string. Uniform tint for all city pulse cores + rings. null falls back to per-hub hardcoded polychrome. | | networkMono | true or false | true | Deprecated. Was the polychrome/mono toggle for network rendering. Ignored. Use arcColor / pulseColor instead. | | routes | true or false | true | Route lines, drawn with the borderless look only. | | routesStrength | 0 to 100 | 82 | | | surface | true or false | true | | | surfaceStrength | 0 to 100 | 30 | | | surfaceColor | hex color | "#18191d" | Solid tint for the sphere fill unless surfaceGradient is set. | | surfaceGradient | gradient or null (see Gradients) | null | Gradient for the sphere fill, by latitude (south → north). | | data | true or false | true | Show the pasted data markers and their arcs. false hides them but keeps dataPoints. | | dataPoints | array of {lat, lng, value}, at most 250 | [] | Data markers, one per point, sized by value. The Data paste box writes this. Points with a missing or out of range lat or lng are dropped, and only the first 250 valid points are kept. | | dataArcs | true or false | false | Draw an arc from each data point to the next, in list order. Needs at least 2 points; arcs show in globe view only. | | dataMarkerColor | hex color or null | null | Hex color for the data markers and their arcs. null uses the default cyan (#7edfff). |

spaceSettings

Starfield + nebula tuning. Applies when backgroundStyle is space.

| Key | Takes | App default | Notes | |---|---|---|---| | density | 0 to 100 | 65 | | | motion | 0 to 100 | 35 | | | nebula | 0 to 100 | 55 | | | hue | 0 to 360 | 0 | | | brightness | 0 to 200 | 100 | |

flowSettings

Animated gradient-mesh tuning. Applies when backgroundStyle is flow.

| Key | Takes | App default | Notes | |---|---|---|---| | colorA | hex color | "#635bff" | | | colorB | hex color | "#00d4ff" | | | colorC | hex color | "#ff5c93" | | | motion | 0 to 100 | 32 | | | turbulence | 0 to 100 | 64 | | | grain | 0 to 100 | 14 | | | scale | 0 to 100 | 52 | | | brightness | 0 to 200 | 104 | |

Gradients

A 2 stop linear gradient, or null for none. Without both from and to it is dropped. dotGradient, worldFillGradient, worldStrokeGradient, globeSettings.gridGradient and globeSettings.surfaceGradient all take this shape.

| Key | Takes | Notes | |---|---|---| | from | hex color | First color, as hex. | | to | hex color | Last color, as hex. | | angle | 0 to 360 | Direction in degrees. | | fromAlpha | 0 to 1 | Opacity of the first color. | | toAlpha | 0 to 1 | Opacity of the last color. |

Example: {"from":"#ff5c93","to":"#00d4ff","angle":90}

Custom shapes

The image drawn as each dot when shape is Custom, or null. An SVG is cleaned of scripts and event handlers before use. The file rides in the link, so one of more than a few dozen kB won't fit in an embed address, which must stay under 32,000 characters.

| Key | Takes | Notes | |---|---|---| | name | text, up to 80 characters | File name. Longer names are cut to 80 characters. | | type | image/svg+xml, image/png, image/jpeg, image/webp | | | dataUrl | text, up to 409,600 characters | The image as a data URL: base64 for PNG, JPEG and WebP, URL encoded markup for SVG. | | svgSource | text | SVG only: the markup. When present the app reads it in place of dataUrl, which a custom shape still needs. |

Shapes

13 values for shape: Circle, Hexagon, Triangle, Pentagon, Square, Voxel, Particle Grid, Diamond, Star, Plus, Ring, ASCII, Custom. Spell them as written: Particle Grid has a space, and ASCII and Custom need asciiSymbol and customShape.

Regions

selection is world, country: plus an uppercase ISO 3166-1 alpha-3 code (country:JPN), continent: plus a continent or subregion: plus a subregion, spelled as below. A name the app doesn't know shows the world.

Continents

6: Africa, Asia, Europe, North America, Oceania, South America. There is no Antarctica.

Subregions

22: Australia and New Zealand, Caribbean, Central America, Central Asia, Central Europe, Eastern Africa, Eastern Asia, Eastern Europe, Melanesia, Middle Africa, North America, Northern Africa, Northern Europe, South America, South-Eastern Asia, Southeast Europe, Southern Africa, Southern Asia, Southern Europe, Western Africa, Western Asia, Western Europe.

Countries the map can't draw

The dotted map has no room for these 70 small countries and territories, so country: with one of them shows the world: ABW, AIA, ALA, AND, ASM, ATG, BES, BHR, BLM, BRB, CCK, COK, COM, CPV, CUW, CXR, CYM, DMA, FRO, FSM, GGY, GIB, GLP, GRD, GUM, HKG, IMN, IOT, JEY, KIR, KNA, LCA, LIE, MAC, MAF, MCO, MDV, MHL, MNP, MSR, MTQ, MUS, MYT, NFK, NIU, NRU, PCN, PLW, PYF, REU, SGP, SHN, SJM, SMR, SPM, STP, SXM, SYC, TCA, TKL, TON, TUV, UMI, UNK, VAT, VCT, VGB, VIR, WLF, WSM.

US states

With selection: "country:USA", stateSelection takes all, a postal code or a FIPS code, and the app stores the FIPS code. Studio and embeds both draw the state. Anything else is dropped.

| Postal | FIPS | Postal | FIPS | Postal | FIPS | Postal | FIPS | |---|---|---|---|---|---|---|---| | AL | 01 | AK | 02 | AZ | 04 | AR | 05 | | CA | 06 | CO | 08 | CT | 09 | DE | 10 | | DC | 11 | FL | 12 | GA | 13 | HI | 15 | | ID | 16 | IL | 17 | IN | 18 | IA | 19 | | KS | 20 | KY | 21 | LA | 22 | ME | 23 | | MD | 24 | MA | 25 | MI | 26 | MN | 27 | | MS | 28 | MO | 29 | MT | 30 | NE | 31 | | NV | 32 | NH | 33 | NJ | 34 | NM | 35 | | NY | 36 | NC | 37 | ND | 38 | OH | 39 | | OK | 40 | OR | 41 | PA | 42 | RI | 44 | | SC | 45 | SD | 46 | TN | 47 | TX | 48 | | UT | 49 | VT | 50 | VA | 51 | WA | 53 | | WV | 54 | WI | 55 | WY | 56 | AS | 60 | | GU | 66 | MP | 69 | PR | 72 | VI | 78 |

Limits

  • An embed address must stay under 32,000 characters: https://globestudio.app/embed?c= plus the encoded config. The site refuses one a little under 32,800 characters long with a 414, so this leaves some room.
  • globeSettings.dataPoints keeps the first 250 valid points.
  • A custom shape's dataUrl is at most 409,600 characters (twice the studio's 200 KB file cap), far past what fits in an embed address.
  • asciiSymbol keeps 12 characters and customShape.name 80.