Skip to content

github/awesome-copilot / skills/globestudio

globestudio

Verified

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.

FileKindSize
SKILL.mdskill md20.3 KB
references/config.mdmarkdown18.6 KB
references/embedding.mdmarkdown11.6 KB
references/looks.mdmarkdown17.6 KB

references/config.md

View on GitHub
# 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.
canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.Stars: 197kUpdated Claude CodeCodexVerifiedInstall