# Quick Reference Card - UI Improvements

## 🎯 Three Improvements at a Glance

| Feature | Location | What It Does | Status |
|---------|----------|--------------|--------|
| **Dark Mode** | Sidebar + Settings | Light/Dark/System appearance | ✅ Ready to use |
| **Scrolling** | Run Meet screen | Left/right + up/down scrolling | ✅ Ready to use |
| **AppIcon** | Xcode Assets | Professional app icon | ⚠️ Setup required |

---

## ⚡ Quick Start

### Using Dark Mode (Instant)
1. Look at bottom of sidebar
2. Click: ○ System  ● Light  ○ Dark
3. Done! (Changes immediately)

### Using Horizontal Scrolling (Instant)
1. Go to "Run Meet" section
2. Open any event with results
3. Scroll left/right in any panel
4. Done! (Just works)

### Setting Up AppIcon (5-10 min)
1. Open `AppIcon_Setup_Instructions.md`
2. Follow the steps
3. Add your icon images
4. Rebuild project
5. Done! (Icon appears everywhere)

---

## 🎨 Dark Mode Quick Reference

| Mode | Behavior | When to Use |
|------|----------|-------------|
| **System** | Follows Mac settings | Auto day/night switching |
| **Light** | Always light mode | Bright environments |
| **Dark** | Always dark mode | Dim lighting, evening meets |

**Access:**
- Quick: Sidebar bottom panel
- Full: Settings (⌘,) > Appearance tab

**Persists:** Yes, saved automatically

---

## ↔️ Scrolling Quick Reference

| Panel | Scrolls | Contains |
|-------|---------|----------|
| **Heat Grid** | ✅ Both | Lane, Athlete, Team, Times |
| **Team Scores** | ✅ Both | Team rankings and points |
| **Splits** | ✅ Both | Per-lane split times |

**How to Scroll:**
- **Vertical:** Normal scroll
- **Horizontal:** Shift + scroll or trackpad swipe

---

## 🔍 Display Zoom Quick Reference

| Control | Affects | Shortcuts |
|---------|---------|-----------|
| **Content Zoom** | Main work area | ⌘+ / ⌘- / ⌘0 |
| **Sidebar Zoom** | Navigation sidebar | Slider only |

**Range:** 75% to 250%  
**Location:** Sidebar bottom + Settings

---

## 📱 AppIcon Checklist

- [ ] Open Xcode
- [ ] Find/create Assets.xcassets
- [ ] Add AppIcon image set
- [ ] Provide icons at all sizes (16-512px)
- [ ] Set target to use "AppIcon"
- [ ] Clean build folder (⇧⌘K)
- [ ] Build and run (⌘R)
- [ ] Check Dock, Finder, ⌘-Tab

**Tip:** Use Icon Set Creator or export from a 1024x1024 PNG

---

## 🎯 Common Use Cases

### Scenario: Outdoor daytime meet
- ✅ Light mode
- ✅ Normal zoom (100%)
- ✅ All scrolling enabled

### Scenario: Evening indoor meet
- ✅ Dark mode
- ✅ Increased zoom (150%)
- ✅ All scrolling enabled

### Scenario: Deck-side officials viewing
- ✅ Dark or Light (preference)
- ✅ Content zoom 175-200%
- ✅ Sidebar zoom 100%
- ✅ Horizontal scroll for wide data

### Scenario: Tight space/small screen
- ✅ Collapse sidebar
- ✅ Reduce zoom to 75-90%
- ✅ Use horizontal scrolling liberally

---

## ⌨️ Keyboard Shortcuts

| Action | Shortcut |
|--------|----------|
| Settings | ⌘, |
| Zoom In | ⌘+ |
| Zoom Out | ⌘- |
| Actual Size | ⌘0 |
| Score Event | ⌘S |

---

## 🐛 Troubleshooting

### Dark mode not changing?
- Try quitting and relaunching app
- Check Settings > Appearance tab matches sidebar
- Verify macOS version is compatible

### Can't scroll horizontally?
- Content must be wider than panel
- Try longer athlete/team names
- Make window narrower to force overflow
- Use Shift + scroll or trackpad swipe

### Icon not appearing?
- Clean build folder (⇧⌘K)
- Delete derived data
- Restart Xcode
- Check Assets.xcassets is in target
- Reset macOS icon cache (terminal command)

### Settings not persisting?
- Check UserDefaults aren't being cleared
- Try manually setting again
- Check console for errors

---

## 📚 Full Documentation

| Document | Purpose |
|----------|---------|
| `AppIcon_Setup_Instructions.md` | Complete icon setup guide |
| `UI_IMPROVEMENTS_SUMMARY.md` | Technical implementation details |
| `USER_GUIDE_New_Features.md` | End-user feature guide |
| `VISUAL_CHANGES_REFERENCE.md` | Before/after visuals |
| `IMPLEMENTATION_CHECKLIST.md` | Testing and deployment checklist |

---

## ✨ Benefits Summary

**Accessibility:**
- ✅ Dark mode reduces eye strain
- ✅ Zoom improves readability
- ✅ Scrolling shows all data

**Professionalism:**
- ✅ Custom icon for branding
- ✅ Polished appearance
- ✅ Native macOS experience

**Usability:**
- ✅ No hidden data
- ✅ User choice and control
- ✅ Instant changes

**Compatibility:**
- ✅ Works with existing meets
- ✅ No data migration needed
- ✅ Preferences persist

---

## 🎓 Training Tips

**For meet operators:**
1. Show them the sidebar appearance controls
2. Demonstrate zoom with ⌘+ and ⌘-
3. Show horizontal scrolling with wide data

**For officials:**
1. Suggest dark mode for evening meets
2. Recommend 150-175% zoom for deck viewing
3. Show how to scroll to see full athlete names

**For IT/Setup:**
1. Install custom icon following the guide
2. Set default zoom if needed
3. Consider pre-configuring appearance preference

---

**Need Help?** Check the full documentation files or review code comments in:
- `UIScale.swift` - Dark mode implementation
- `MeetManagerApp.swift` - Settings integration
- `RunMeetView.swift` - Scrolling implementation

---

*Version: 2.0 | Last Updated: 2026-05-30*
