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
70 lines
2.9 KiB
Markdown
70 lines
2.9 KiB
Markdown
# 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()` via `page.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:
|
|
1. **Getting Started** - Setup wizard, timezone, deployment mode (partial)
|
|
2. **Theme Customization** - Theme builder modal, presets (partial)
|
|
3. **Viewing Logs** - Complete workflow
|
|
4. **Quick Search** - Complete workflow
|
|
5. **Backup & Restore** - Complete workflow (UI)
|
|
6. **Stats Monitoring** - Complete workflow (UI)
|
|
|
|
### Workflows Not Fully Documented:
|
|
1. **Deploy First App** - App selector empty, couldn't complete
|
|
2. **Dark Theme Toggle** - Theme builder works but quick toggle doesn't
|
|
3. **Service Status Cards** - Not deeply explored
|
|
4. **Smart Arr Setup** - Not explored
|
|
|
|
## Recommendations
|
|
|
|
1. App Selector needs app catalog/backend to show templates
|
|
2. Menu expansion should be tested with real user interaction
|
|
3. Test instance should have some sample services running to show actual data in logs/stats
|
|
4. Consider adding a "demo mode" with fake data for tutorial purposes
|