# 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