# Quick User Guide: New UI Features

## 🎨 Dark Mode

**Where to find it:**
- **Quick access:** Bottom of the sidebar navigation panel
- **Full settings:** Swim Meet Toolkit menu > Settings (⌘,) > Appearance tab

**How to use:**
1. Click on one of three options:
   - **System** (🖱️): Follows your Mac's appearance settings
   - **Light** (☀️): Always uses light mode (dark text on white)
   - **Dark** (🌙): Always uses dark mode (light text on dark)

2. The change applies instantly!

**When to use each mode:**
- **Light Mode:** Bright environments, daytime outdoor meets, well-lit pool decks
- **Dark Mode:** Evening meets, dim lighting, reduces eye strain for long sessions
- **System:** Let your Mac decide based on time of day

**Tip:** You can keep your Mac in light mode but run the meet software in dark mode independently!

---

## ↔️ Horizontal Scrolling (Run Meet Screen)

**What's new:**
All panels in the "Run Meet" screen now scroll both up/down AND left/right.

**Which panels:**
- ✅ **Heat Grid** (center panel with lane results)
- ✅ **Team Scores** (top right panel)
- ✅ **Splits** (bottom right panel)

**How to scroll:**
- **Mouse/Trackpad:** 
  - Vertical: Scroll wheel or two-finger swipe up/down
  - Horizontal: Shift + scroll wheel or two-finger swipe left/right
- **Magic Mouse:** Natural scrolling in any direction

**Why it matters:**
- Long athlete names no longer get cut off
- Team names fully visible even with narrow windows
- Split times are readable without resizing
- Works great on smaller displays or when space is tight

**Tip:** If content looks too wide or narrow, adjust the window size or use the Content Zoom slider in the sidebar!

---

## 🔍 Display Size Controls

**Where to find it:**
- Bottom of the sidebar navigation panel
- Settings > Appearance tab

**Two independent zoom controls:**

1. **Content Size** (📝)
   - Zooms the main work area (events, results, reports)
   - Great for showing officials across the deck
   - Keyboard shortcuts:
     - Zoom In: ⌘+
     - Zoom Out: ⌘−
     - Reset to 100%: ⌘0

2. **Sidebar Size** (📑)
   - Zooms just the navigation sidebar
   - Keep nav small while enlarging work area, or vice versa
   - Controlled via slider only

**Range:** 75% to 250%

**Reset button:** Click the ↻ button next to each percentage to reset to 100%

**Tip:** Try Content at 150% and Sidebar at 100% for optimal deck-side viewing!

---

## 📱 AppIcon

**What is it:**
The app icon appears in:
- Your Dock while the app is running
- Finder when browsing applications
- App switcher (⌘-Tab)
- Spotlight search

**Setup required:**
If you don't see an icon, follow the instructions in `AppIcon_Setup_Instructions.md` to add your custom icon images to the project.

---

## 💡 Tips for Best Experience

**For bright outdoor meets:**
- Use Light Mode
- Reduce Content Zoom if needed (bright screens are easier to read smaller)

**For evening/indoor meets:**
- Use Dark Mode
- Increase Content Zoom for easier reading in dim lighting
- Horizontal scrolling helps when you need to fit more on screen

**For deck-side officials:**
- Bump Content Zoom to 150-200%
- Keep Sidebar at 100% so you can still navigate easily
- Use Dark Mode to reduce glare off the screen

**For tight spaces:**
- Collapse the sidebar (click sidebar button in toolbar)
- Enable horizontal scrolling to see all columns
- Use the icon-only sidebar to save screen space

---

## ⌨️ Keyboard Shortcuts

**Appearance:**
- Open Settings: ⌘,

**Zoom:**
- Zoom In: ⌘+
- Zoom Out: ⌘−
- Actual Size: ⌘0

**Navigation:**
- Collapse/Expand Sidebar: Click toolbar button
- Switch sections: Click sidebar items

---

## ❓ FAQ

**Q: Does Dark Mode affect printing?**  
A: No, reports and printouts always use high-contrast black text on white paper for readability.

**Q: Can I zoom individual sections?**  
A: The Content Zoom applies to all detail panels (events, athletes, reports, run meet). The Sidebar has its own independent zoom.

**Q: Will my settings be saved?**  
A: Yes! Your color scheme and zoom preferences are saved automatically and restored when you launch the app.

**Q: Can I use different settings for different meets?**  
A: Settings are app-wide, not per-meet. However, you can change them anytime and they apply immediately.

**Q: The horizontal scrolling isn't working?**  
A: Make sure your content is actually wider than the panel. Try adding longer team names or athlete names to test. Also ensure you're in the Run Meet screen.

---

Need more help? Check the full documentation in `UI_IMPROVEMENTS_SUMMARY.md`
