Faster Motion is a JSON-authored motion system. A .fmtion file describes metadata, parameters, inputs, scenes, graph nodes, assets, and runtime behavior; the loader turns that source into DOM writes, Canvas rendering, and debug-visible graph state.

What the runtime owns

• DOM animation owns webpage element motion: selectors, scroll progress, pointer input, text pieces, SVG/path progress, CSS variables, and property writes.
• Canvas animation owns rendered surfaces: mount sizing, scene objects, images, spritesheets, text, state machines, data tables, assets, and render lifecycle.
• 3D/procedural animation uses the modern scenes[] shape with kind: "3d", camera, lights, renderer settings, scene graph nodes, and optional cross-scene texture outputs.
• The debug surface is always available in loaded pages as FasterMotion.debug, so authoring and support can inspect live graph state instead of guessing from screenshots.

Source-backed contract

• The generated schema currently has 204 definitions and requires meta at the root.
• The public node registry currently exposes 292 descriptors. Node pages should derive from that registry rather than hand-maintained tables.
• Legacy DOM, Canvas, and older 3D fields still exist in the schema during migration, but new docs should prefer graph-based authoring and the scenes[] model where it applies.

How to verify work

• Validate static JSON shape before loading when possible.
• Load the file into a production-equivalent page, then run FasterMotion.debug.validate().
• Use debug.nodes(), debug.inspect(selector), debug.sceneWires(), debug.textures(), and physics readers based on the surface being tested.
• For public Faster pages, verify desktop and mobile rendering after publish, not only local source validity.

Verified runnable examples

This guide points to proof-backed sample coverage. The full ledger lives in Generated examples and proof log.

DOM: Scroll fade reveal

• Source: faster-motion/demo/tests/dom/catalog/scroll-animations/fade-reveal/fade-reveal.domgraph.fmtion
• Expected output: Sections fade and translate into place as their trigger elements enter the configured viewport range.
• Validation: Schema validation passed. Runtime proof reports zero structural/runtime issues and 17 loaded nodes.
• Desktop proof: generated-assets/faster-motion-docs/proofs/screenshots/dom-fade-reveal-desktop.png
• Mobile proof: generated-assets/faster-motion-docs/proofs/screenshots/dom-fade-reveal-mobile.png

Canvas: Fill rule diagnostic

• Source: faster-motion/demo/tests/canvas/fillrule-diagnostic/fillrule-diagnostic.fmtion
• Expected output: A contained Canvas scene renders paired path cases so nonzero and evenodd fill handling can be compared visually.
• Validation: Schema validation passed. Runtime proof reports zero blocking runtime issues and 10 rendered objects; the accepted metadata note is preserved in the proof ledger.
• Desktop proof: generated-assets/faster-motion-docs/proofs/screenshots/canvas-fillrule-diagnostic-desktop.png
• Mobile proof: generated-assets/faster-motion-docs/proofs/screenshots/canvas-fillrule-diagnostic-mobile.png

Guide-specific sample target: Overview sample pair: one DOM graph and one Canvas scene using the same parameter name so readers can compare the two surfaces.

Faster Motion docs

Use this local map together with the left navigation. The source-backed content tree controls the main article order; this section keeps related pages one click away.

Start

• Faster Motion docs map
• Faster Motion documentation overview
• Get started with Faster Motion
• Faster Motion concepts
• .fmtion file format

DOM animation

• DOM animation guide
• DOM selectors and targets
• Scroll animation
• Pointer, hover, and drag inputs
• Text, SVG, and path animation
• Responsive gates and parameter overrides

Canvas animation

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

3D and procedural

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

Reference

• Node reference index
• Node categories reference
• Runtime loading and publishing
• Runtime API reference
• Debugging and preflight
• Debug API reference
• Validation errors and warning codes
• Faster Motion production checklist
• Faster Motion recipes overview