The debug API is the primary read channel for live Faster Motion state. Use it before guessing why a graph is not producing the expected visual.

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.

Start with validation

• Run validation first. It catches missing selectors, invalid selectors, bad wires, runaway scroll ranges, physics setup issues, and malformed responsive conditions.
• Treat error-severity validation results as blockers. Treat warnings as review items that need an explicit accept or fix decision.
• Use static validation against JSON when possible, then validate the live graph after the page loads.

Inspect live graph state

• Use node snapshots to see node IDs, types, parameters, connections, and last output values.
• Use selector inspection to map a DOM target to the graph nodes that read or write it.
• Use scroll, pin, gate, override, physics, and dump methods to narrow complex failures without rewriting the motion file.

What to include in a bug report

• Include the page URL, .fmtion file path, viewport size, selected breakpoint, validation output, and a focused debug dump.
• Include the expected visual result and the actual observed result.
• Avoid private customer or business data in public bug reports; redact page content where needed.

Working sample slot

Debug 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