Builder Module - Troubleshooting

Common Issues and Solutions

Canvas Not Loading

1. Verify plugin settings:

   • Check if the Builder module is enabled
   • Ensure canvas storage location is valid
   • Verify file permissions

2. Try these steps:

   • Restart Obsidian
   • Clear canvas cache
   • Create a new canvas

Node Connection Issues

1. Invalid connections:

   • Verify connection types match
   • Check node compatibility
   • Ensure proper connection direction

2. Connection display problems:

   • Refresh the canvas view
   • Check for visual conflicts
   • Verify node positions

Performance Issues

1. Slow canvas response:

   • Reduce number of nodes
   • Simplify complex connections
   • Clear unused elements
   • Consider splitting into multiple canvases

2. Memory usage:

   • Monitor resource usage
   • Close unused canvases
   • Optimize workflow complexity

Error Handling

The Builder module includes robust error handling:

• Clear error messages for common issues
• Automatic recovery for connection problems
• Canvas state preservation
• Graceful degradation when features are unavailable

Frequently Asked Questions

Q: Can I use multiple canvases simultaneously? A: Yes, you can open multiple canvases and switch between them.

Q: Are canvas layouts saved automatically? A: Yes, all changes are automatically saved to your vault.

Q: Can I share canvases between vaults? A: Yes, canvas files can be copied between vaults, but ensure all required resources are available.

Reporting Issues

If you encounter persistent issues:

1. Enable debug logging in settings
2. Reproduce the issue
3. Check the console for error messages
4. Submit a detailed report through GitHub or Discord

For customization options and advanced settings, see Advanced Features.