The runtime API is the bridge between a page and a .fmtion file. It should be used deliberately so motion files mount, update, and dispose without leaving stale page state.

Where this fits

• Faster Motion docs map shows the full documentation structure.
• Faster Motion documentation overview explains the high-level surfaces and reading order.
• Debugging and preflight explains validation before publish.

Load and mount

• Load the .fmtion JSON before attaching it to the DOM or Canvas mount that owns the visual.
• Keep the page mount selector and the file mount selector aligned. A mismatch should be treated as a publish blocker.
• When a page has multiple motion files, give each instance its own lifecycle and debug label.

Control and parameters

• Play and pause should be explicit when motion depends on route state, tab visibility, modal state, or viewport presence.
• Parameter updates should use named paths and expected value shapes so debug output remains readable.
• Avoid writing parameters from several page systems unless the ownership and precedence are documented.

Dispose and cleanup

• Dispose motion instances when the page route, section, modal, or component is removed.
• Cleanup should remove listeners, animation frames, Canvas state, and any DOM writes that should not persist.
• After dispose, verify that reopening the page or component creates a clean new instance.

Working sample slot

Runtime API reference: This page reserves a sample location for a later verified example. Add the sample only after the source file, public page, validation output, and visual check all pass.

Faster Motion docs

Use these links to move between the guide set, the deeper reference pages, and the recipe planning pages. Verified working samples will be inserted after this documentation structure is reviewed.

Start

• Faster Motion documentation overview
• Get started with Faster Motion
• Faster Motion concepts

Surfaces

• DOM animation guide
• Canvas animation guide
• Canvas 3D and procedural guide

Reference

• .fmtion file format
• Runtime loading and publishing
• Debugging and preflight
• Node reference index

Start

• Faster Motion docs map

DOM animation

• DOM selectors and targets
• Scroll animation
• Pointer, hover, and drag inputs
• Text, SVG, and path animation

Reference

• Responsive gates and parameter overrides
• Runtime API reference
• Debug API reference
• Validation errors and warning codes
• Node categories reference

Canvas animation

• Canvas area lifecycle
• Canvas objects, assets, and rendering
• Canvas inputs and state machines

3D and procedural

• 3D scenes, cameras, and lights
• Procedural geometry and fields
• Particles and physics

Operations

• Production checklist

Recipes

• Recipes overview