Add getting started tutorials for DashCaddy

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
This commit is contained in:
Krystie
2026-05-01 20:53:01 -07:00
parent bb69b96816
commit fbe1a7c95c
40 changed files with 1232 additions and 0 deletions

View File

@@ -0,0 +1,69 @@
# 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