fbe1a7c95c
Tutorials covering: - Getting Started (setup wizard, timezone, deployment modes) - Theme Customization (theme builder, presets, color customization) - Viewing Logs (log viewer, live streaming, filtering) - Quick Search (keyboard shortcuts, navigation) - Backup & Restore (manual/automated backup, restore workflow) - Stats Monitoring (resource monitor, live stats, alerts) Also includes: - Self-contained HTML getting started guide - 30+ screenshots capturing UI workflows - Issues/notes documenting test instance observations Workflows documented: - Light theme screenshots - Dark theme screenshots (partial - theme builder) - App selector (noted as empty in test instance) - Theme builder modal - Logs viewer - Quick search - Backup modal - Stats monitoring Total: 6 tutorial files, 30+ screenshots, 1 HTML guide
2.9 KiB
Issues and Notes
Test Instance Observations
App Selector Empty
The App Selector modal opens but shows no apps in the grid. The "Choose an App" message appears with just a Cancel button. This could mean:
- The test instance doesn't have app templates loaded
- The app catalog API isn't responding
- The apps need to be fetched from a backend that's not configured
Impact: Could not complete "Deploy Your First App" workflow
Workaround: App selector needs backend/app catalog to be configured
Menu Navigation Issues
The TOOLS, STATUS, and ADMIN sections in the dashboard have expandable menus. Clicking on section headers (like "TOOLS") didn't expand the menu via standard click methods in headless Chrome.
Impact: Could not navigate to some features through normal menu interaction
Workaround: Used JavaScript to directly show modals by manipulating CSS display property
Theme Switching Not Working Properly
The "🎨 Light" button in the top bar appears to be a display of current theme rather than a toggle. Clicking it doesn't switch themes.
Impact: Theme workflow only partially captured - theme builder modal opens but theme switching via the quick button doesn't work
Workaround: Use Theme Builder modal to change themes
Logs/Services Show "Loading..."
Some services show "Loading logs..." or "Loading container stats..." which suggests the backend APIs aren't returning data in the test instance.
Impact: Could see the UI for these features but not actual data
Workaround: Document UI even when no data is present
Technical Observations
Puppeteer/Chromium Issues
- Background Chromium processes were being killed by SIGKILL
- Some clickable elements weren't being recognized as clickable by puppeteer
- Had to use JavaScript clicks (
element.click()viapage.evaluate()) for some interactions
Session Management
- TOTP codes expire every 30 seconds
- Had to generate fresh TOTP for each session
- Used
process.exit(0)to avoid graceful cleanup issues that triggered process kills
Screenshots Captured
Workflows Documented:
- Getting Started - Setup wizard, timezone, deployment mode (partial)
- Theme Customization - Theme builder modal, presets (partial)
- Viewing Logs - Complete workflow
- Quick Search - Complete workflow
- Backup & Restore - Complete workflow (UI)
- Stats Monitoring - Complete workflow (UI)
Workflows Not Fully Documented:
- Deploy First App - App selector empty, couldn't complete
- Dark Theme Toggle - Theme builder works but quick toggle doesn't
- Service Status Cards - Not deeply explored
- Smart Arr Setup - Not explored
Recommendations
- App Selector needs app catalog/backend to show templates
- Menu expansion should be tested with real user interaction
- Test instance should have some sample services running to show actual data in logs/stats
- Consider adding a "demo mode" with fake data for tutorial purposes