Live Map
Where the money is coming from: a slowly turning globe, a ranked list of cities, and the day replayed.
Built from MapGlobe (with its sized, ranked, watch-ringed markers and your own card on the hovered city), Flag, SegmentedControl, FilterChip, Tabs, Badge, Button, IconButton and LocationDot. The data is plain props, so you feed it from your own stream. Below 720px of its own width it becomes the phone layout, with the list as a bottom sheet.
Live Map
Pick a city in the list or on the globe: the panel becomes that city's detail and the globe turns to face it. Switch the metric, filter by region, press Replay today to play the day back, or use the rotate button to stop the spin. The clock ticks in real time.
Where your payments are coming fromWhere payments come from
Bigger dots mean more revenue today. Pick a city to see what is driving it.
Bigger dots mean more revenue. Tap a city for details.
Europe is leading
London brings in $334K, 8.5% of today. Tokyo is running 18% above forecast.
How to read this
Bigger dots = more revenue ·
Lines show payments settling to Singapore
Selecting a city
Where your payments are coming fromWhere payments come from
Bigger dots mean more revenue today. Pick a city to see what is driving it.
Bigger dots mean more revenue. Tap a city for details.
How to read this
Bigger dots = more revenue ·
Lines show payments settling to Singapore
Loading and empty
Loading keeps the layout still with skeletons; empty says no payments have settled yet.
Where your payments are coming fromWhere payments come from
Bigger dots mean more revenue today. Pick a city to see what is driving it.
Bigger dots mean more revenue. Tap a city for details.
Bigger dots = more revenue ·
Lines show payments settling to Singapore
Where your payments are coming fromWhere payments come from
Bigger dots mean more revenue today. Pick a city to see what is driving it.
Bigger dots mean more revenue. Tap a city for details.
No payments yet today
Cities appear here as soon as the first payment settles.
Bigger dots = more revenue ·
Lines show payments settling to Singapore
On a phone
The block reads its own width, not the window's: at 390px it shows the metric switch full width, the filters in a scrolling row, a one-line insight, the legend behind the info button, and the top cities in a bottom sheet.
Where your payments are coming fromWhere payments come from
Bigger dots mean more revenue today. Pick a city to see what is driving it.
Bigger dots mean more revenue. Tap a city for details.
Europe is leading
London brings in $334K, 8.5% of today. Tokyo is running 18% above forecast.
How to read this
Bigger dots = more revenue ·
Lines show payments settling to Singapore
Your data
A COMPOSITION EXAMPLE: copy the folder and replace sample.ts, or pass your own props. Each city carries its figures; the block does the ranking, the dot sizes, the shares and the forecast colours.
The shape of a city, with the Figma block's Tokyo.
| Prop | Type | Default | Description |
|---|---|---|---|
| id, name, country, countryName | string | country is the two-letter code: it becomes the city's flag in the list, the hover card, the detail and the phone rows. | |
| region | string | The id of one of `regions`. | |
| position | [lat, lng] | Where the dot sits. | |
| timeZone | string | An IANA zone, for "22:42 local" in the hover card. | |
| revenue, payments, approvalRate, avgPayment | number | Today's figures. They drive the dot sizes, the ranking and the detail. | |
| vsForecast | number | Revenue against forecast, in percent: 6 shows "+6% vs forecast", -2 shows "-2% vs forecast" in amber. | |
| status | 'healthy' | 'watch' | 'healthy' | watch gives the dot a dashed amber ring and the detail a Watch badge. |
| methods | { label, share }[] | Share of revenue by payment method, in percent. |
Accessibility
- The ranked list is the accessible version of the globe: every city is a button there, with its figures as text.
- Status is never only a colour: a city to watch has a dashed ring on the globe, a Watch badge and amber text.
- The globe turns slowly and holds still under the pointer, while a city is selected and under reduced motion. The rotate button is a toggle (
aria-pressed); it is not shown under reduced motion. - Loading is announced as a busy status; the hover card is decorative and repeats what the list says.
LiveMapBlock props
| Prop | Type | Default | Description |
|---|---|---|---|
| cities | LiveMapCity[] | The cities: dots on the globe and rows in the list. Defaults to the sample data from the Figma block. | |
| regions | { id, label, center }[] | The filter chips after "All regions". Choosing one turns the globe to its center. | |
| hourly | number[] | Payment volume for each hour of today (24 numbers, UTC). Hours after the current one are not drawn. | |
| totals | { revenue, payments, approvalRate, vsForecast, cities } | Figures across every city, for the headline and "Top 5 of 40 cities". | |
| insight | { title, body, short } | The "Right now" card (and the phone's one-line pill). | |
| hubId | string | The id of the city the arcs settle to. Defaults to Singapore, else the first city. | |
| state | 'default' | 'loading' | 'empty' | 'default' | Loading draws skeletons; empty is "No payments yet today". |
| selectedId / defaultSelectedId / onSelectedChange | string | null | The selected city, controlled or not. Picking a city in the list or on the globe turns the globe to it. | |
| hoveredId | string | Pins the hover look and card on one city without a pointer: documentation and visual tests. | |
| defaultMetric | 'revenue' | 'payments' | 'approval' | 'revenue' | What the dots, the ranking and the figures show first. |
| now | Date | The moment to show. Left out, the clock runs on real time and ticks; given, it is frozen there. | |
| autoRotate | boolean | true | Turn the globe slowly and offer a rotate button that stops and restarts it. It holds still under the pointer, while a city is selected, and under reduced motion. |
| atmosphere | boolean | true | The glow around the globe. |
| title / mobileTitle / description / mobileDescription | string | The heading and its line, on a desktop and on a phone. | |
| onViewCity | (city) => void | The primary button in a city's detail ("View Tokyo payments"). | |
| onViewAll | () => void | "View all cities" under the list. |
Copy the source
Blocks are composition examples, not configurable components. Rather than adding props for a layout they don't support, copy the file into your own project and edit it: change the columns, swap the sample data, delete the parts you don't need. Nothing here introduces a primitive you can't already import on its own.