People Globe
A dotted globe where people pin their city and photo.
Features
- •Pin yourself — Two steps: your name and a city search that fills in city, state and country, then a photo (cropped and shrunk in the browser) or your initials.
- •Avatar pins — Each person is a round avatar that follows the globe. Everyone in the same city shares one pin with stacked avatars and a count, and a card lists them all.
- •Feels physical — Drag or flick to spin with momentum, a slow spin when idle, and a smooth flight to any pin or newly added person.
- •Bring your own data — Pass people in and save new ones with onAdd to any backend, or use storageKey to keep pins in the browser. Place the add form inside the globe or anywhere on the page.
- •Light and crisp — A canvas globe of land dots built once from Natural Earth shapes, high-DPI aware, and paused while offscreen.
- •Accessible — Pins are labelled buttons, the city search is a keyboard-friendly combobox, and reduced motion turns off the spin and flights.
Props API Reference
11 configurable props| Prop | Type | Default | Description |
|---|---|---|---|
| people | GlobePerson[] | [] | People on the globe: name, city, state?, country, countryCode?, lat, lng, avatar?. |
| onAdd | (person) => void | Promise<void> | undefined | Save a new person to your backend; rejecting shows an error. |
| allowAdd | boolean | true | Show the Add your place button on the globe. |
| storageKey | string | undefined | Keep people added in this browser (localStorage) under this key. |
| searchPlaces | (query, signal) => Promise<GlobePlace[]> | Open-Meteo | City search; the default free geocoder is for non-commercial use. |
| focus | { lat, lng, id? } | null | null | Fly to a place, and open that person's card when id matches. |
| title / showCount | string / boolean | "People around the world" / true | The corner title and people count. |
| autoRotate / rotationSpeed | boolean / number | true / 6 | Idle spin, in degrees per second. |
| dotColor / accentColor | string | "#FFFFFF" | Land dots, and pins and buttons. |
| background / textColor | string | "#000000" / "#FFFFFF" | Page and text colours. |
| AddPlaceForm | component | — | The two-step add form on its own, for a sidebar or page beside the globe. |