Skip to main content

Syncing Modes

One of Redd's unique features is the seamless synchronization between the Visual Builder and the JSON Editor. You never have to choose one over the other; they are two different views of the same data.

How it Works

When you are editing a monitor, you will see tabs to switch between "Visual" and "JSON".

  1. Visual to JSON: As you add conditions or change logic in the UI, the underlying JSON is updated in real-time.
  2. JSON to Visual: If you type or paste valid JSON into the editor, the Visual Builder will instantly re-render to reflect the new structure.

Preserving Your Logic

The sync engine is designed to be "lossless." Even if you build a deeply nested structure in JSON that is difficult to represent visually, Redd will do its best to render it accurately in the Visual Builder.

Use Cases for Switching

The "Paste and Refine" Workflow

  1. Open the JSON Editor.
  2. Paste a long list of keywords into the Values array of a condition.
  3. Switch to the Visual Builder to visually verify the logic and perhaps add a few more conditions using the point-and-click interface.

The "Debug" Workflow

If you aren't sure why a complex visual filter isn't working as expected, switch to the JSON Editor. Seeing the raw structure can often make logic errors (like an accidental OR where you meant AND) much more obvious.

Sync Errors

If you enter invalid JSON (e.g., a syntax error), the sync will pause. The Visual Builder will not update until the JSON is corrected. This prevents your visual work from being overwritten by broken code.