> ## Documentation Index
> Fetch the complete documentation index at: https://hyperframes.heygen.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Arc Motion Path

> A GSAP MotionPath primitive that flies a callout along a curved arc with autorotation.

export const InstallCommand = ({command}) => {
  const [copied, setCopied] = React.useState(false);
  const copy = async () => {
    try {
      if (navigator.clipboard && window.isSecureContext) {
        await navigator.clipboard.writeText(command);
      } else {
        const previous = document.activeElement;
        const scratch = document.createElement("textarea");
        scratch.value = command;
        scratch.setAttribute("readonly", "");
        scratch.style.position = "fixed";
        scratch.style.opacity = "0";
        document.body.appendChild(scratch);
        scratch.select();
        document.execCommand("copy");
        document.body.removeChild(scratch);
        previous?.focus?.();
      }
      setCopied(true);
      setTimeout(() => setCopied(false), 2000);
    } catch {}
  };
  return <div className="hf-install-command not-prose my-4 flex items-stretch overflow-hidden rounded-xl border border-zinc-200 bg-zinc-50 dark:border-zinc-800 dark:bg-zinc-900">
      <code className="flex-1 overflow-x-auto whitespace-nowrap border-r border-zinc-200 px-4 py-3 font-mono text-sm text-zinc-800 dark:border-zinc-800 dark:text-zinc-100">
        {command}
      </code>
      <button type="button" onClick={copy} data-copied={copied ? "true" : "false"} aria-label={`Copy ${command} to the clipboard`} className="hf-install-copy">
        <svg className="hf-install-copy-clipboard" xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 18 18" fill="none" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">
          <path d="M14.25 5.25H7.25C6.14543 5.25 5.25 6.14543 5.25 7.25V14.25C5.25 15.3546 6.14543 16.25 7.25 16.25H14.25C15.3546 16.25 16.25 15.3546 16.25 14.25V7.25C16.25 6.14543 15.3546 5.25 14.25 5.25Z" />
          <path d="M2.80103 11.998L1.77203 5.07397C1.61003 3.98097 2.36403 2.96397 3.45603 2.80197L10.38 1.77297C11.313 1.63397 12.19 2.16297 12.528 3.00097" />
        </svg>
        <svg className="hf-install-copy-check" xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 18 18" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">
          <path d="M2.75 9.5L6.5 13.25L15.25 4.5" />
        </svg>
      </button>
      <span className="hf-install-copy-status" role="status" aria-live="polite">
        {copied ? "Copied" : ""}
      </span>
    </div>;
};

<iframe className="w-full aspect-video rounded-xl border-0 bg-zinc-100 dark:bg-zinc-800" title="arc-motion-path preview" loading="lazy" srcDoc={`<!doctype html><html><head><meta charset="utf-8"><style>html,body{margin:0;height:100%;overflow:hidden;background:transparent}hyperframes-player{display:block;width:100%;height:100%}</style><script src="https://cdn.jsdelivr.net/npm/@hyperframes/player@0.7/dist/hyperframes-player.global.js"><\/script></head><body><script>fetch("/public/catalog/components/arc-motion-path.json").then(function(r){return r.json()}).then(function(d){var p=document.createElement("hyperframes-player");p.setAttribute("srcdoc",d.html);p.setAttribute("controls","");p.setAttribute("autoplay","");p.setAttribute("loop","");p.setAttribute("muted","");p.setAttribute("poster","https://static.heygen.ai/hyperframes-oss/docs/images/catalog/components/arc-motion-path.png");document.body.appendChild(p)});<\/script></body></html>`} />

## Install

<InstallCommand command="npx hyperframes add arc-motion-path" />

That writes one file: `compositions/components/arc-motion-path.html`.

## Source

<Accordion title={`arc-motion-path.html`}>
  ```html theme={null}
  <!--
    Arc Motion Path - advanced HyperFrames primitive.

    This is intentionally seekable: drive it from a paused GSAP timeline.
    MotionPath examples require GSAP MotionPathPlugin. Three.js examples expose
    a render(progress) adapter instead of a free-running requestAnimationFrame loop.
  -->

  <div class="hf-advanced-arc-motion-path">
    <svg viewBox="0 0 760 430" aria-hidden="true">
      <path
        id="arc-motion-path-path-a"
        class="path"
        d="M104 310 C178 110, 334 74, 442 178 S592 306, 668 120"
      />
      <path id="arc-motion-path-path-b" class="path" d="M118 142 C224 300, 410 330, 642 206" />
    </svg>
    <div class="core">Arc Motion Path</div>
    <div class="chip chip-a"><span class="dot"></span>Plan</div>
    <div class="chip chip-b"><span class="dot"></span>Render</div>
  </div>

  <style>
    .hf-advanced-arc-motion-path {
      color: var(--fg, #111827);
      font-family: var(--font-body, Inter, system-ui, sans-serif);
    }
    .hf-advanced-arc-motion-path {
      position: relative;
      width: 760px;
      height: 430px;
      border-radius: var(--radius, 30px);
      overflow: hidden;
      background: radial-gradient(
        circle at 50% 20%,
        var(--bg, #f4f4f5),
        var(--bg, #f8fafc) 54%,
        var(--bg, #e4e4e7)
      );
      box-shadow: 0 28px 80px rgba(15, 23, 42, 0.18);
    }
    .hf-advanced-arc-motion-path svg {
      position: absolute;
      inset: 0;
      width: 100%;
      height: 100%;
      overflow: visible;
    }
    .hf-advanced-arc-motion-path .path {
      fill: none;
      stroke: color-mix(in srgb, var(--fg, #111827) 18%, transparent);
      stroke-width: 3;
      stroke-dasharray: 10 12;
    }
    .hf-advanced-arc-motion-path .core {
      position: absolute;
      left: 50%;
      top: 50%;
      width: 176px;
      height: 176px;
      margin: -88px 0 0 -88px;
      border-radius: 42px;
      background: var(--fg, #111827);
      color: var(--bg, #fff);
      display: grid;
      place-items: center;
      text-align: center;
      font-weight: 900;
      letter-spacing: -0.04em;
      box-shadow: 0 22px 54px rgba(15, 23, 42, 0.25);
    }
    .hf-advanced-arc-motion-path .chip {
      position: absolute;
      left: 0;
      top: 0;
      display: inline-flex;
      align-items: center;
      gap: var(--space-1, 8px);
      height: 42px;
      padding: 0 var(--space-2, 16px);
      border-radius: var(--radius, 999px);
      background: var(--surface, #fff);
      box-shadow: 0 16px 42px rgba(15, 23, 42, 0.14);
      font-weight: 800;
      transform-origin: 50% 50%;
    }
    .hf-advanced-arc-motion-path .dot {
      width: 10px;
      height: 10px;
      border-radius: var(--radius, 999px);
      background: var(--accent, #18181b);
    }
  </style>

  <!--
    Timeline integration:
    const startTime = 0;
    if (window.MotionPathPlugin) gsap.registerPlugin(MotionPathPlugin); tl.to('.hf-advanced-arc-motion-path .chip-a', { motionPath: { path: '#arc-motion-path-path-a', align: '#arc-motion-path-path-a', alignOrigin: [0.5, 0.5], autoRotate: true }, duration: 2.4, ease: 'power1.inOut' }, startTime); tl.to('.hf-advanced-arc-motion-path .chip-b', { motionPath: { path: '#arc-motion-path-path-b', align: '#arc-motion-path-path-b', alignOrigin: [0.5, 0.5], autoRotate: true, start: 0.1, end: 0.92 }, duration: 2.1, ease: 'sine.inOut' }, startTime + 0.25);
  -->
  ```
</Accordion>

## Usage

Open `compositions/components/arc-motion-path.html` and paste its contents into your composition. The comment header describes the timeline integration and any optional dependency setup.

Tagged `video-primitive` `motionpath` `gsap-plugin` `hyperframes-native`.

## Related topics

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


## Related topics

- [Edit Operations](/sdk/reference/edit-operations.md)
- [Figma integration](/guides/figma.md)
- [Edit animation and keyframes](/studio/animation.md)
