Debugging Faster Motion starts with validation. A motion file can look close while still carrying broken selectors, dead ports, competing writers, invalid media gates, or a render surface that only works at one viewport.

Preflight checks

• Validate the .fmtion JSON shape before publishing.
• Check node ports and connection names against generated metadata.
• Run runtime validation on the public page or a production-equivalent preview.
• Capture desktop and mobile screenshots for visual surfaces.
• Confirm reduced-motion handling where animation intensity could affect usability.

Runtime debug tools

The existing Faster Motion debug docs describe window.FasterMotion.debug methods such as validate(), validateFmtion(json), nodes(), inspect(selector), pins(), scroll(), and dump(). Public docs should start with validate() and then route people toward the right inspection method.

Common failure classes

• A selector matches no elements at bind time.
• A wire points at a node or port name that does not exist.
• Two writers target the same transform component.
• A scroll trigger cannot produce the intended runway.
• A Canvas or 3D mount exists but renders blank, cropped, or offscreen.
• A responsive gate is malformed and silently does not gate the node.

What to record

• The .fmtion file path and version.
• The public page URL and viewport tested.
• Validation output and any accepted warning codes.
• Screenshots or video proof for DOM, Canvas, and 3D surfaces.
• The exact sample or node category that failed.

Working sample slot

Debug sample: Insert a before/after validation example once a safe public sample can intentionally demonstrate one warning and its fix. 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

• 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

Related product guides

• Add motion to a page
• Use the visual editor for page motion
• Create a Canvas visual
• Meet the Visual Motion Editor