Help guide

.fmtion file format

Updated June 19, 2026

.fmtion file format

Product media placeholder

Replace this area with a screenshot or short walkthrough video during the media sweep.

A .fmtion file is a JSON document that describes motion in a way the Faster Motion runtime can load, validate, and execute. It can contain DOM animation, Canvas animation, or both.

Common root fields

  • meta: name, description, duration, fps, and other file-level information.
  • parameters: named values that can be read or written by inputs, graphs, UI, or runtime code.
  • inputs: scroll, pointer, time, keyboard, and other sources that update parameters or graph values.
  • dom and domGraph: webpage animation definitions and node graphs.
  • canvas or scenes: Canvas and 3D render surfaces, scene resources, and graph nodes.
  • assets: images, fonts, audio, video, sprites, 3D assets, or other resources used by the runtime.

Minimal file

{
  "meta": { "name": "Untitled motion" },
  "parameters": {},
  "dom": [],
  "canvas": []
}

Connection shape

{
  "id": "write-title",
  "type": "domPropertyWrite",
  "params": {
    "selector": ".hero-title",
    "propertyName": "opacity"
  },
  "connections": {
    "value": { "nodeId": "fade", "port": "value" }
  }
}

Authoring principle

Prefer graph-readable structure over opaque custom code. If a value changes over time, make the driver, computation, and writer visible in the graph so the runtime, validator, editor, and docs can all reason about it.

Working sample slot

Format sample: Insert a complete small .fmtion file with one DOM graph and one Canvas graph after both are verified. This page intentionally reserves the sample location so the live docs can ship before the verified examples are inserted.

Faster Motion docs

Use these pages as the first public Faster Motion documentation set. Working samples will be inserted after each sample is verified.

Start

Surfaces

Reference

Related product guides

Was this guide helpful?

Sunny Arora

Written by

Sunny Arora

Get technical deep dives delivered to your inbox

Join creators and developers who get exclusive insights, tutorials, and behind-the-scenes content every week.

No spam. Unsubscribe anytime.

Continue Exploring

You might also enjoy