Troubleshooting

Try the following:

• •Refresh the page (Ctrl+R or Cmd+R)
• •Clear browser cache (Ctrl+Shift+Delete)
• •Try a different browser
• •Check your internet connection
• •Open Developer Tools (F12) and check the Console tab for errors

If performance is poor:

• •Close other browser tabs to free up memory
• •Reduce the number of widgets on your canvas
• •Split complex designs into multiple canvas tabs
• •Try a different browser with better performance
• •Check if browser extensions are interfering

Don't panic! Try:

• •Check if you're using Private/Incognito mode (storage is cleared on close)
• •Refresh the page to reload from local storage
• •Check if you imported a different project (overwriting the current design)
• •If lost, try to recreate from memory

If added widgets don't show up:

• •Check if the widget is positioned outside canvas bounds
• •Verify the widget's width and height are greater than 0
• •Check the Properties panel to see the widget's position
• •The widget might be hidden behind another item - check z-index
• •Try clicking the widget in the element tree (left sidebar)
• •Refresh the page to redraw the canvas

Regarding color issues:

• •Ensure you're using valid hex format: #RRGGBB or 0xRRGGBB
• •The preview shows colors as they'll appear on the device
• •LVGL color format might differ from standard RGB on some devices
• •Test on your actual device to verify colors

To fix layout issues:

• •Use the Properties panel to precisely set position and size
• •Use Container widgets to group related elements
• •Consider breaking large layouts into multiple screens
• •Plan your layout on graph paper first
• •Preview mode can help visualize the final layout

If YAML import fails:

• •Ensure the file is valid YAML format
• •Check that the YAML uses the correct structure
• •Try exporting an existing design to see the correct format
• •Look for error messages in the import dialog
• •Try importing a simpler file first to test

If your YAML has issues:

• •Validate YAML syntax using an online YAML validator
• •Copy the YAML exactly - don't modify unless necessary
• •Check for special characters that need escaping
• •Report the issue if you suspect a designer bug

When deploying YAML:

• •Ensure your ESPHome version supports LVGL
• •Check for YAML formatting issues in ESPHome logs
• •Verify all referenced fonts and images exist
• •Test with a simple design first
• •Check ESPHome documentation for LVGL integration requirements

If widget selection isn't working:

• •Try clicking directly on the widget on the canvas
• •Use the element tree in the right sidebar
• •Check if another widget is covering it
• •Try zooming the canvas to make the widget larger

For drag issues:

• •Try dragging from the center of the widget
• •Use the Properties panel to set position instead
• •Try a different mouse or input device
• •Ensure no browser extensions are interfering