# 📅 Calendar Quick Start Guide

## Accessing the Calendar

1. **Via Navigation**: Work → Calendar
2. **Direct URL**: `/timer/calendar`

---

## 🚀 Quick Actions

### Create a Time Entry
1. Select a project from the dropdown at the top
2. Click and drag on the calendar to select time
3. Fill in optional details (task, notes, tags)
4. Click "Create"

### Edit a Time Entry
**Quick Edit:**
- Drag event to move it
- Drag edges to resize it

**Full Edit:**
- Click event → Click "Edit" button

### Filter Entries
- **By Project**: Select from "All Projects" dropdown
- **By Task**: First select project, then select task
- **By Tags**: Type in the tags field

### Export Calendar
1. Click "Export" button
2. Choose format:
   - **iCal** → Import to your calendar app
   - **CSV** → Open in Excel/Sheets

### Change View
- Click **Day**, **Week**, **Month**, or **Agenda**
- Click **Today** to jump to current date

---

## 🎨 Visual Features

### Color Coding
- Each project has a distinct color
- Easy to identify entries at a glance
- 10 colors rotate across projects

### Real-time Indicators
- **Red line**: Current time
- **Blue highlight**: Today
- **Dimmed**: Past events

---

## 💡 Pro Tips

1. **Pre-select Project**: Always select a project before creating entries
2. **Drag to Create**: Fastest way to log time
3. **Use Filters**: Find specific entries quickly
4. **Agenda View**: Best for mobile devices
5. **Export Regularly**: For invoicing and reporting

---

## 📱 Mobile Usage

On mobile:
- Use **Day** or **Agenda** view (better than Week)
- Tap event to view details
- Use filters to reduce clutter
- Portrait orientation works best

---

## 🐛 Troubleshooting

**Events not showing?**
- Check your filters (click "Clear")
- Verify you're in the right date range
- Ensure you have time entries

**Can't create entries?**
- Select a project first
- Check you're clicking on the calendar

**Export not working?**
- Check popup blocker
- Ensure date range has events

---

## 📚 Full Documentation

For complete details, see:
- **[Calendar Features README](docs/CALENDAR_FEATURES_README.md)** - Complete guide
- **[Calendar Improvements Summary](CALENDAR_IMPROVEMENTS_SUMMARY.md)** - What's new

---

**Happy Time Tracking! ⏰**

