webflow-editor-integration

Detect Webflow Designer mode and branch runtime logic for editor-safe behavior.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/BamoJ/wf-starter-fed-v1 --skill webflow-editor-integration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: webflow-editor-integration
Source: https://github.com/BamoJ/wf-starter-fed-v1/tree/main/.cursor/skills/webflow-editor-integration
Command: npx skills add https://github.com/BamoJ/wf-starter-fed-v1 --skill webflow-editor-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents your Webflow Designer/Editor experience from being disrupted by custom runtime behavior, so components remain usable and visually correct while editing.

Core Features & Use Cases

  • Designer vs Published behavior switching: Detects when Webflow is in editor mode and applies editor-safe logic instead of production behaviors.
  • Interaction safety: Ensures editing usability by adjusting pointer events and visual transforms so custom code does not block Designer interactions.
  • Animation and lifecycle control: Resets JS-applied styles and conditionally skips observer/animation setup to avoid confusing or incorrect editor rendering.

Quick Start

Tell the skill to add editor detection around your component so editor mode applies static, CSS-defined state while the published site initializes animations, observers, and page-transition behavior.

Frequently Asked Questions about webflow-editor-integration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why do my custom Webflow animations break the Designer mode?

Custom Webflow animations break Designer mode because runtime scripts apply visual transforms and blocking interactivity that interfere with editing. Detecting editor mode lets you conditionally skip animation initialization and reset styles so components remain visually correct.

How do I detect Webflow editor mode to skip custom scripts?

You detect Webflow editor mode by using the @webflow/detect-editor handleEditor method to branch your logic. This allows you to conditionally initialize or skip editor-inappropriate features like scroll observers and page transitions.

How do I reset JavaScript styles for Webflow components in the editor?

To reset JavaScript styles in the Webflow editor, use editor detection to branch logic and apply editor-safe logic. This resets transforms and opacities, disabling blocking interactivity so custom code does not disrupt Designer interactions.

What is the best way to handle Webflow Designer versus published site behavior?

The best way to handle Webflow Designer versus published site behavior is detecting editor mode to apply static, CSS-defined states while editing. The published site then initializes animations, observers, and page-transition behavior safely.

Does Webflow custom code affect pointer events in the Designer?

Yes, Webflow custom code can affect pointer events in the Designer by blocking interactivity. Editor detection allows you to disable blocking pointer events and adjust visual transforms, ensuring editing usability remains intact.

When should I not use scroll observer logic in Webflow?

You should not use scroll observer logic in Webflow when the site is loaded inside the Designer or Editor. Conditionally skipping observer and animation setup prevents confusing or incorrect editor rendering.