What should I do if YAML changes aren't appearing on the canvas?

First, validate your YAML structure using the CLI build command. If valid, check the Plugin Main console for rendering or patching errors.

Why is my FigJam plugin stuck on 'Connecting'?

This usually indicates the CLI server isn't running or there is a port conflict. Ensure the CLI is running via 'bun run' and check if port 3456 is available.

Where can I view the plugin's error logs?

You can right-click the plugin UI to 'Inspect' the console for WebSocket events, or use Figma Desktop > Plugins > Development > Open console for the main thread errors.

How do I fix a secret mismatch error?

Ensure the '--secret' flag value provided to the CLI matches the secret value configured within your FigJam plugin instance.

Figram Connection Debugger

Name: Figram Connection Debugger
Author: 7nohe

by7nohe

•

设计工具

Troubleshoots and resolves WebSocket communication issues between the Figram CLI and FigJam plugins.

关于

The Figram Connection Debugger is a specialized skill designed to diagnose and fix synchronization problems between the Figram CLI and the Figma/FigJam environment. It provides comprehensive guidance on resolving common connectivity hurdles such as port conflicts, secret mismatches, and YAML validation errors. By detailing the architecture of the WebSocket bridge and providing specific debugging steps for both the CLI and the Figma console, this skill ensures that your YAML-driven architecture diagrams sync perfectly to your canvas without interruption.

主要功能

Step-by-step WebSocket connectivity troubleshooting
Secret mismatch and authentication resolution
Visual message flow mapping for state synchronization
YAML validation and parsing error identification
CLI and Figma console inspection guides
1 GitHub stars

使用场景

Resolving indefinite 'Connecting...' states in the FigJam plugin
Fixing authentication and docId mismatch errors between CLI and Figma
Debugging failed canvas updates when YAML files are modified

关于

主要功能

Step-by-step WebSocket connectivity troubleshooting
Secret mismatch and authentication resolution
Visual message flow mapping for state synchronization
YAML validation and parsing error identification
CLI and Figma console inspection guides
1 GitHub stars

使用场景

Resolving indefinite 'Connecting...' states in the FigJam plugin
Fixing authentication and docId mismatch errors between CLI and Figma
Debugging failed canvas updates when YAML files are modified