- Docs
- Components
- Interface
- Data & Media
- Signal Map
A dotted world map with signals arcing between cities
| Name | Type | Default | Description |
|---|---|---|---|
points | SignalPoint[] | 16 world cities | The locations. Each point is { id, label, lat, lng, value? }. value shows next to the label, like a latency or a count. |
routes | [string, string][] | any pair | Pairs of point ids that signals travel between. Without routes, signals fly between random pairs. |
projection | "miller" | "equirectangular" | "natural" | "miller" | Map projection. Natural is Equal Earth, with rounded edges. Equirectangular is the flat, wide plate carrée. |
density | number | 150 | Dots across the full width of the map. Dots never get closer than 3px, so small maps use fewer. |
dotSize | number | 0.5 | Dot size as a share of the spacing between dots. |
dotShape | "circle" | "square" | "circle" | Shape of each land dot. |
grid | "hex" | "square" | "hex" | Hex offsets every other row. Square lines the dots up in columns. |
ocean | boolean | false | Draws faint dots over the sea, which shows the outline of the projection. |
rate | number | 1.2 | Signals launched per second while autoplaying. |
travel | number | 1600 | Base flight time in milliseconds. Longer routes take longer. |
arcHeight | number | 0.3 | How far each route bows upward, as a share of its length. |
trail | number | 0.32 | Length of the light trail behind each signal. |
trace | boolean | true | Leaves a faint line along the route that fades after the signal lands. |
ripple | boolean | true | Lights a ring of map dots around each point a signal reaches. |
rippleSize | number | 1 | Size of the ripples. |
markers | boolean | true | Shows a dot at each point. |
labels | "hover" | "always" | "none" | "hover" | When to show point labels. Always works best with a few well-spaced points. |
autoplay | boolean | true | Launches signals on its own while the map is in view. |
interactive | boolean | true | Hovering a point shows its label, clicking it sends signals to a few others. |
height | number | auto | Fixed height in pixels. The map is fitted inside it. By default the height follows the projection. |
theme | "auto" | "light" | "dark" | "auto" | Auto picks light or dark colours from the background behind the map. |
accentColor | string | theme violet | Colour of signals, ripples and markers. |
dotColor | string | from theme | Colour of the land dots. |
textColor | string | from theme | Colour of the labels. |
ref | { send, burst } | — | send(from, to) launches one signal between two point ids, burst(from) sends several from one point. |
className | string | — | Classes for the root element. |
style | CSSProperties | — | Inline styles for the root element. |
pointsSignalPoint[]The locations. Each point is { id, label, lat, lng, value? }. value shows next to the label, like a latency or a count.
16 world citiesroutes[string, string][]Pairs of point ids that signals travel between. Without routes, signals fly between random pairs.
any pairprojection"miller" | "equirectangular" | "natural"Map projection. Natural is Equal Earth, with rounded edges. Equirectangular is the flat, wide plate carrée.
"miller"densitynumberDots across the full width of the map. Dots never get closer than 3px, so small maps use fewer.
150dotSizenumberDot size as a share of the spacing between dots.
0.5dotShape"circle" | "square"Shape of each land dot.
"circle"grid"hex" | "square"Hex offsets every other row. Square lines the dots up in columns.
"hex"oceanbooleanDraws faint dots over the sea, which shows the outline of the projection.
falseratenumberSignals launched per second while autoplaying.
1.2travelnumberBase flight time in milliseconds. Longer routes take longer.
1600arcHeightnumberHow far each route bows upward, as a share of its length.
0.3trailnumberLength of the light trail behind each signal.
0.32tracebooleanLeaves a faint line along the route that fades after the signal lands.
trueripplebooleanLights a ring of map dots around each point a signal reaches.
truerippleSizenumberSize of the ripples.
1markersbooleanShows a dot at each point.
truelabels"hover" | "always" | "none"When to show point labels. Always works best with a few well-spaced points.
"hover"autoplaybooleanLaunches signals on its own while the map is in view.
trueinteractivebooleanHovering a point shows its label, clicking it sends signals to a few others.
trueheightnumberFixed height in pixels. The map is fitted inside it. By default the height follows the projection.
autotheme"auto" | "light" | "dark"Auto picks light or dark colours from the background behind the map.
"auto"accentColorstringColour of signals, ripples and markers.
theme violetdotColorstringColour of the land dots.
from themetextColorstringColour of the labels.
from themeref{ send, burst }send(from, to) launches one signal between two point ids, burst(from) sends several from one point.
—classNamestringClasses for the root element.
—styleCSSPropertiesInline styles for the root element.
—