RemotionUI
Spatial

Map Canvas

Deterministic MapLibre map mount.

PrimitivespatialAdvanced

Install
npx remotion-ui@latest add map-canvas

Low-level MapLibre mount with delayRender until the map is idle. Use as the foundation for custom map animations.

Advanced — installs maplibre-gl. Render with --gl=angle --concurrency=1.

AI usage

Install first, then import the copied source component locally.

AI guide

Install

npx remotion-ui@latest add map-canvas

Import after install

@/remotion/primitives/map-canvas
  • Use when: map scenes, routes, markers, and spatial storytelling.
  • Customize: center, zoom, onMapReady, plus copied source for timing, layout, colors, and typography.
  • Rule: do not import this component from the remotion-ui npm package; it is copied into your project.

Usage

import { MapCanvas } from "@/remotion/primitives/map-canvas";

<MapCanvas center={[8.54, 47.38]} zoom={7} onMapReady={setMap} />

API Reference

PropTypeDescription
center*[number, number]Map center [lng, lat].
zoomnumberInitial zoom level.
onMapReady(map: Map) => voidCalled when map is idle.

Related