Kartograf / A map animation library

The world is
not still.

For you and your agent

Skip the docs. Paste this.

Copy this into Claude, Codex, Cursor or any coding agent. It reads the Kartograf skill, builds the story and validates it before handing it back.

Use the Kartograf agent skill:
https://kartograf.cc/skills/kartograf/SKILL.md

Build a 30-second map animation about [your route or place].
Use this CDN build:
https://cdn.kartograf.cc/kartograf/latest/kartograf.min.js

Validate the story with kartograf.validateStory before playing.
Return one self-contained HTML file and a short list of scene timings.
01 / Geography, with feeling

Kartograf turns places, routes and data into animated stories for the web. Start with the map. Let the movement give it meaning.

Kartograf / Visual study 01
A route becomes
a narrative.
Illustration / not a live renderSee real stories ↗
02 / A way to see

A map is not the backdrop. It is the story.

From coordinates

Use geographic features and scenes to give a journey its shape. Direct where the viewer looks, and when.

To connection

Let motion reveal relationships between places instead of asking a static map to explain everything at once.

04 / Build with Kartograf

One script. A map in motion.

Kartograf is a browser-native animation engine for MapLibre. Describe scenes, routes and camera moves in JSON; the engine handles the timing, easing and rendering. No framework, no bundler, no npm install.

  • 0125 geometry types — routes, arcs, timelines, choropleths, flow lines, 3D extrusions, labels, fog and masks.
  • 02Camera choreography — flyTo, fitBounds, orbit, shake and timed multi-stage sequences.
  • 03Composable motion — a line draws while an icon travels; a region reveals while the camera pulls back.
  • 04Cinematic finish — bloom, vignette, focus pull and 3D LUT color grading.
index.html · CDN
<script src="https://cdn.kartograf.cc/kartograf/latest/kartograf.min.js"></script>

<script>
// kartograf = new Kartograf({ mapInstance: map })

const story = kartograf.createStory({
  scenes: [{
    camera: { zoomLevel: 7, pitch: 30 },
    features: [{
      geometry: {
        type: 'LinePointString',
        coordinates: [[28.978, 41.008], [32.860, 39.933]],
      },
      marker: { type: 'PULSING' },
      line: { color: '#c9a87c', width: 4 },
    }],
  }],
});

await story.play();
</script>
Your next story starts somewhere

Start with a place.

Experiment with a scene in the playground, or explore the current library through its documentation.