---
title: "US Bubble Map"
description: "Animated US bubble map with proportional city markers, value callouts, and connection lines — composable with us-map"
---

<video className="w-full aspect-video rounded-xl object-cover bg-zinc-100 dark:bg-zinc-800" src="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/us-map-bubble.mp4" poster="https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/us-map-bubble.png" autoPlay muted loop playsInline />

## Install

```bash Terminal
npx hyperframes add us-map-bubble
```

That writes one file: `compositions/us-map-bubble.html`.

## Add it to your video

It runs for 12 seconds at 1920×1080. Paste this into your composition:

```html index.html
<div
  data-composition-id="us-map-bubble"
  data-composition-src="compositions/us-map-bubble.html"
  data-start="0"
  data-duration="12"
  data-track-index="1"
  data-width="1920"
  data-height="1080"
></div>
```

Move it in time with `data-start`. Put it on a different timeline row with
`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.

{/* hf:generated-footer */}

Tagged `data` `map` `geography` `usa` `bubble` `cities`.

## Related topics

- [Browse the complete Catalog](/catalog)
- [Add assets and Catalog items in Studio](/studio/assets-and-blocks)
- [Build a richer composition](/go-further)