4.6 KiB
🚀 Testing Builder - Step by Step
Status: Enhanced debugging has been uploaded to your device ✓
Quick Start Test
Step 1: Open Browser Console
- Open builder in browser
- Press
F12to open Developer Tools - Click "Console" tab
- You should see a blank console (or "Welcome to DevTools")
Step 2: Load HOME Page
- Select "Home" from Pages list
- You should see cyan boxes appear on canvas
Step 3: Click on Weather Panel
- Look for the large cyan box at the top of the canvas
- Click on it (click in the middle)
- Properties should appear on the RIGHT side
Step 4: Change the Color
- With Weather Panel selected, find the "Color" field
- Click the color picker (the colored square)
- Choose RED color
- The cyan box should immediately turn RED
Step 5: Click "Apply Changes"
- Click the blue "Apply Changes" button
- You should see a toast saying "Saving..."
- Then it should say "✓ Changes saved to device"
Step 6: Check the Console
- Look at the browser console (F12)
- You should see blue messages like:
[BUILDER] Applying properties to widget: {...}
[BUILDER] Widget after applying properties: {...}
[BUILDER] Saving overlay for page 0
[BUILDER] Overlay widgets: [...]
[BUILDER] Overlay saved successfully
Step 7: Check the LCD
- Look at your device LCD
- The Weather Panel should now be RED
What Each Console Message Means
✓ GOOD (You should see these):
[BUILDER] Applying properties to widget: {type: "panel", x: 45, y: 20, ...}
→ Widget was selected correctly
[BUILDER] Widget after applying properties: {type: "panel", x: 45, y: 20, color: "...", ...}
→ Color was changed in the widget object
[BUILDER] Saving overlay for page 0
→ System is sending save request to device
[BUILDER] Overlay widgets: [Array]
→ Array of modified widgets is being sent
[BUILDER] Overlay saved successfully
→ Device confirmed it received and saved the changes
❌ BAD (If you see these, something's wrong):
No [BUILDER] messages at all
→ Console logging isn't working, refresh the page
[BUILDER] Saving overlay for page undefined
→ Page selection is broken, try reloading
TypeError: Cannot read property 'overlayElements'
→ State object is corrupted, reload page
If RED Doesn't Appear on LCD
Check 1: Is the Toast Showing?
EXPECTED: ✓ Changes saved to device
ACTUAL: [what do you see?]
Check 2: Is the Console Error Free?
Look for any RED text in console (F12) Copy any error messages and send to me
Check 3: Does LCD Respond at All?
Try navigating to different pages on device If device is frozen: Power cycle it
Power Cycle Instructions
- Unplug device from power (USB)
- Wait 10 seconds
- Plug back in
- Wait 30 seconds for boot
- Try again
Exact Steps to Report Issues
When something doesn't work, tell me:
- Which step failed? (1-7 above)
- What did you expect? (describe)
- What actually happened? (describe)
- Console messages (copy from F12 console)
- Error text (if any, copy exact red text)
Example Report:
ISSUE: Color change not appearing on LCD
STEP THAT FAILED: Step 7
EXPECTED: Weather Panel should turn RED on LCD
ACTUAL: Panel stayed BLUE on LCD
CONSOLE MESSAGES:
[BUILDER] Applying properties to widget: {...}
[BUILDER] Widget after applying properties: {color: "#FF0000", ...}
[BUILDER] Saving overlay for page 0
✓ Changes saved to device
(no errors)
NEXT ACTION: I tried power cycling device, still blue
Debug Checklist
- Can I see cyan boxes on HOME page?
- Can I click on Weather Panel?
- Can I change color to RED?
- Does "Apply Changes" show success toast?
- Do I see [BUILDER] messages in console?
- Does LCD show RED weather panel?
- Does RED persist after power cycle?
Once you complete these steps and see the RED color on LCD, the builder is working! 🎉
What to Do Next
-
Try changing SIZE (not just color)
- Select widget
- Change Width to 200
- Click Apply
- Should see BIGGER widget on LCD
-
Try changing POSITION (X, Y)
- Select widget
- Change X to 100
- Click Apply
- Should see MOVED widget on LCD
-
Try creating CUSTOM PAGE
- Click "Add Page" button
- Name it "Test"
- Add some widgets
- Deploy
- Should work!
-
Report SUCCESS or FAILURE
- Tell me which tests passed
- Tell me which tests failed
- Send console output if errors
Questions?
If anything is unclear, ask and I'll help debug!
The enhanced logging should help us see exactly where the problem is. 🔍