# Time Tracking

Track time spent on work items for billing, reporting, and project management.

## Starting a Timer

### From the Timer Widget

The floating timer widget is always accessible:

1. Click the timer icon in the bottom corner
2. Select a work item (optional)
3. Click Start

### From a Work Item

1. Open a work item
2. Click "Start Timer" in the sidebar
3. The timer starts automatically

## Stopping a Timer

Click Stop on the timer widget. You'll be prompted to:

- Confirm the duration
- Add a description
- Select a project (for billing)

## Manual Entry

Don't want to use a timer? Log time manually:

1. Open a work item
2. Click "Log Time"
3. Enter duration (e.g., `2h 30m`, `1.5h`, `90m`)
4. Add description and date

### Duration Formats

| Format | Meaning |
|--------|---------|
| `2h` | 2 hours |
| `30m` | 30 minutes |
| `2h 30m` | 2 hours 30 minutes |
| `1.5h` | 1 hour 30 minutes |
| `90m` | 90 minutes |
| `1d` | 1 day (8 hours) |

## Projects and Billing

Associate time entries with projects for billing:

1. Create projects in Settings > Time Tracking
2. Set hourly rates per project
3. Select project when logging time
4. Generate invoices from reports

## Reports

View time tracking reports:

- **By person** - See who worked on what
- **By project** - Track project budgets
- **By work item** - See total time per item
- **By date range** - Weekly, monthly summaries

### Export

Export time entries as CSV for:

- Invoicing
- Payroll
- External reporting

## Settings

Configure time tracking behavior:

- **Rounding** - Round entries to nearest 15/30 minutes
- **Required fields** - Make description mandatory
- **Auto-stop** - Stop timer after inactivity