# Phase 3: Calendar Integration - Context

**Gathered:** 2026-01-24
**Status:** Ready for planning

<domain>
## Phase Boundary

Enable connection to external calendar services (Google Calendar and Apple Calendar) and display calendar events alongside user tasks in the weekly view. Users can view, filter, and manage calendar events within the application's weekly scheduler interface.

</domain>

<decisions>
## Implementation Decisions

### UI Integration Approach
- Calendar events visually distinguished from user tasks using different background colors
- Calendar events styled with a distinct visual style (outlined instead of filled)
- Calendar events displayed using overlapping indicators that don't block task space
- Basic time and title information displayed for calendar events

### Event Filtering Behavior
- Default visibility state remembers last used setting
- Per-calendar toggle controls implemented for individual calendar visibility management
- OpenCode's discretion on positioning of toggle controls and temporary hiding capabilities

### Calendar Connection Flow
- Google Calendar uses OAuth 2.0 with redirect authentication flow
- Apple Calendar authentication approach to be determined by OpenCode
- Support for multiple calendar accounts (Google and Apple)
- OpenCode's discretion on connection status indicators

### Data Synchronization Strategy
- Real-time updates for calendar event synchronization
- Automatic retry of failed sync attempts
- OpenCode's discretion on selective sync options and conflict resolution

### OpenCode's Discretion
- Positioning of calendar event toggle controls
- Temporary hiding capabilities for events
- Apple Calendar authentication approach
- Connection status indicators
- Selective sync options
- Conflict resolution strategies

</decisions>

<specifics>
## Specific Ideas

- "I want calendar events to be clearly distinguishable from user tasks in the UI"
- "The filtering should remember user preferences from previous sessions"
- "Real-time updates are important for keeping the calendar accurate"

</specifics>

<deferred>
## Deferred Ideas

- Calendar event creation/editing/deletion (part of Phase 4)
- Data export/import capabilities (part of Phase 4)
- Advanced calendar management features (part of Phase 4)

</deferred>

---
*Phase: 03-calendar-integration*
*Context gathered: 2026-01-24*