7.5 KiB
LCD Builder - Keyboard Shortcuts & Features Guide
Keyboard Shortcuts
Undo & Redo
| Shortcut | Action | Notes |
|---|---|---|
| Ctrl+Z (Windows/Linux) or Cmd+Z (Mac) | Undo | Reverses last action (20 state history) |
| Ctrl+Shift+Z (Windows/Linux) or Cmd+Shift+Z (Mac) | Redo | Reapplies undone action |
| Ctrl+Y (Windows/Linux) or Cmd+Y (Mac) | Redo | Alternative redo shortcut |
| Delete | Delete Selected Widget | Removes currently selected widget |
Toolbar Buttons
| Button | Icon | Action | Keyboard |
|---|---|---|---|
| Add Label | + | Opens widget palette | N/A |
| Delete | 🗑️ | Deletes selected widget | Delete key |
| Copy | 📋 | Copies selected widget to clipboard | N/A |
| Paste | 📌 | Pastes widget with 16px offset | N/A |
| Undo | ↶ | Undoes last change | Ctrl+Z |
| Redo | ↷ | Redoes last undone change | Ctrl+Y |
| Save | 💾 | Downloads overlay as JSON | N/A |
| Deploy | 📤 | Sends overlay to LCD with verification | N/A |
| Presets | 📑 | NEW Opens preset management | N/A |
| Reset | 🔄 | NEW Reset to default layouts | N/A |
New Features (Phase 1)
1. Undo/Redo History
What: Full undo/redo for all builder operations
How: Use Ctrl+Z to undo, Ctrl+Y to redo
Limit: 20 actions stored (prevents memory bloat)
Tracked Actions:
- ✅ Add widget
- ✅ Delete widget
- ✅ Edit properties
- ✅ Paste widget
- ✅ Drag widget to new position
- ✅ Copy from base layer
Example Workflow:
- Add 5 widgets
- Delete 2 accidentally
- Press Ctrl+Z twice to restore them
- Press Ctrl+Y once to delete them again
2. Preset System (Save/Load Layouts)
What: Save your current layout as a named preset, then restore it later
How: Click 📑 "Presets" button → Save current layout → Give it a name
Storage: Saved in SPIFFS (persistent across reboots)
Presets Included: Timestamps show when each was saved
Example Workflow:
- Create custom layout (add 10 widgets, arrange nicely)
- Click Presets button
- Enter name: "My Dark Theme"
- Click "Save Preset"
- Later: Click Presets → Click "Load" on "My Dark Theme"
- Your layout is restored instantly
Features:
- ✅ Save unlimited presets
- ✅ Load any preset (overwrites current layout)
- ✅ Delete presets you don't need
- ✅ Timestamps show creation time
- ✅ Persists across device reboot
3. Reset to Defaults (Safety Feature)
What: One-click restore of original layouts
Why: Safety net if editing goes wrong
How: Click 🔄 "Reset" button → Confirm in dialog → All reverted
What Gets Reset:
- ✅ All custom overlays cleared
- ✅ Custom pages removed
- ✅ Original builtin pages reloaded
- ✅ Undo/redo history cleared
Important: This is permanent and can't be undone (outside of undo stack before reset)
Example Workflow:
- Accidentally delete all widgets
- Click Reset button
- Confirm the red "RESET" button
- Original layouts restored
4. Deploy Verification
What: Deploy now confirms layout actually reached the LCD
How: Automatic - happens after deploy
Shows:
- ✅ "Deploying..." while sending
- ✅ "Verifying..." while checking
- ✅ "✓ Deployment verified: 12 widgets deployed" on success
- ✅ "⚠ Partial: sent 12, received 8" if something went wrong
Benefits:
- No more guessing if deploy worked
- Catch network glitches immediately
- Clear feedback on what happened
Operation Summary
Common Tasks
Add a Widget
- Click widget type in palette (Label, Value, Icon, etc.)
- Drag onto canvas
- Position by dragging
- Edit properties in sidebar
Edit Widget Properties
- Click widget on canvas to select
- Properties panel shows all editable fields
- Change values (position, size, text, color, etc.)
- Changes apply immediately
- Use Ctrl+Z if you make a mistake
Delete a Widget
- Click widget to select
- Press Delete key OR click Delete button
- Widget removed from canvas
- Use Ctrl+Z to restore if accidental
Copy & Paste Widget
- Click widget to select
- Click Copy button (or Ctrl+C manually)
- Click Paste button
- New widget appears offset by 16px
- Move to desired position
Undo Recent Changes
- Press Ctrl+Z repeatedly to step back through history
- Each press goes back one action
- Use Ctrl+Y to step forward (redo)
- Up to 20 recent actions available
Save Your Layout
- Arrange all widgets perfectly
- Click Presets button (📑)
- Type a name: "Dashboard Home", "Dark Mode", etc.
- Click "Save Preset"
- Layout saved permanently
Load a Saved Layout
- Click Presets button (📑)
- Find your preset in the list
- Click "Load" button
- Your saved layout appears
- Continue editing or deploy it
Reset Everything
- If something went very wrong...
- Click Reset button (🔄)
- Read confirmation carefully
- Click red "RESET" button
- Original layouts restored completely
Deploy to Device
- Select which page to deploy to
- Click Deploy button (📤)
- Watch for status: "⏳ Deploying..." → "🔍 Verifying..."
- Get confirmation: "✓ Deployment verified: X widgets"
- Changes appear on LCD instantly
Tips & Tricks
Pro Tips
- Name Your Presets Clearly: Use descriptive names like "Dark Dashboard" not "Layout1"
- Save Before Big Changes: If about to try something risky, save a preset first
- Use Keyboard Shortcuts: Much faster than clicking buttons
- Drag to Move: Click and drag widgets on canvas - faster than editing X/Y
- Undo Often: No penalty, so experiment freely with Ctrl+Z nearby
- Check Deployment: Always verify deploy succeeded (check the message)
Troubleshooting
"Deploy failed"
- Check you selected a page
- Check network connection
- Try again
"Undo doesn't work"
- Only 20 actions stored - very old changes can't be undone
- Reset clears the undo stack
- Take a preset before major changes
"Preset won't save"
- Name can't be empty
- Name can't be longer than 32 characters
- Device might be out of storage
"Reset is grayed out"
- Some pages are locked (can't reset individual pages)
- Reset resets entire system
Keyboard Shortcut Cheat Sheet (Print This!)
UNDO/REDO
Ctrl+Z Undo (Windows/Linux) or Cmd+Z (Mac)
Ctrl+Y Redo (Windows/Linux) or Cmd+Y (Mac)
Ctrl+Shift+Z Redo alternative (Windows/Linux)
Delete Delete selected widget
QUICK REFERENCE
Presets 📑 Button - Save/load/delete layouts
Reset 🔄 Button - Restore original layouts
Deploy 📤 Button - Send to LCD with verify
Copy/Paste 📋→📌 Buttons - Duplicate widgets
Widget Types Available
| Type | Use For | Properties |
|---|---|---|
| Label | Static text | Text, position, size, color, font size |
| Value | Dynamic numbers | Text format, position, size, color |
| Icon | Emoji/symbols | Icon char, position, size, color |
| Shape | Boxes/decorations | Shape type, position, size, color, radius |
| Button | Interactive areas | Text, position, size, color, radius, binding |
Presets Storage Info
Where Stored: SPIFFS filesystem on device
Persistence: Survives power loss and reboots
Limit: ~12 presets typical (depends on widget count)
Format: Each preset stores widget array with name and timestamp
Reset Effect: Reset operation doesn't delete presets
Questions?
For more help:
- Check the builder tooltips (hover over buttons)
- Read the API documentation
- Review the implementation guides in docs/
Enjoy building! 🎨