> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Timeline

> Manage your events and schedule

## Overview

The Qwox Timeline is your central hub for managing events, appointments, and deadlines. Unlike traditional calendars, Timeline intelligently organizes your schedule with AI-powered features like automatic event detection from images/files, conflict warnings, and smart categorization.

## Timeline Views

### View Modes

The Timeline offers four filtering modes to help you focus on what matters:

| Mode         | Description                       | Time Range               |
| ------------ | --------------------------------- | ------------------------ |
| **Past**     | Events that have already occurred | Last 30 days             |
| **Today**    | Events happening today            | Current day only         |
| **Upcoming** | Future events                     | Next 60 days             |
| **All**      | Complete timeline view            | 60 days before and after |

### Event Display

Events are grouped by date with:

* **Relative Date Labels**: "Today", "Tomorrow", "In 3 days"
* **Event Count**: Number of items per day
* **Color-Coded Icons**: Visual indicators for event types
* **Category Badges**: Quick identification of event categories
* **Attachment Previews**: Thumbnails for linked images/files

## Creating Events

Qwox offers **4 different ways** to create events:

### 1. Via Chat Panel (Mobile & Web)

1. Open the chat screen
2. Tap the **+** button
3. Select "Add Event"
4. Fill in event details
5. Save

### 2. Via Header (Web Only)

For users not in chat:

1. Click the **+** button in the header
2. Select "Add Event"
3. Complete the event form
4. Save

### 3. Via AI Natural Language

Simply tell Qwox about your event:

```text theme={null}
"I have a doctor appointment tomorrow at 2pm"
"Schedule team meeting for Monday 10am"
"Remind me about Sarah's birthday on May 10th"
```

Qwox will automatically:

* Detect the date and time
* Suggest a category
* Open the event creation modal for confirmation

### 4. Via OCR Detection (Automatic)

When you upload images or files (PDFs, screenshots), Qwox automatically:

1. Scans for dates and times
2. Detects event information (flights, concerts, appointments)
3. Shows a suggestion popup
4. Pre-fills event details if you accept

**Supported Documents**:

* Flight tickets
* Concert tickets
* Appointment confirmations
* Meeting invitations
* Any document with date/time information

## Event Modal Features

### Basic Information

| Field              | Description           | Required                  |
| ------------------ | --------------------- | ------------------------- |
| **Title**          | Event name            | ✅ Yes                     |
| **Date & Time**    | When it happens       | ✅ Yes                     |
| **All-Day Toggle** | Mark as all-day event | No                        |
| **Category**       | Event type            | ✅ Yes (default: Personal) |

### Categories

Choose from 11 pre-defined categories:

<CardGroup cols={3}>
  <Card title="Work" icon="briefcase">
    Meetings, deadlines, projects
  </Card>

  <Card title="Personal" icon="person">
    Personal appointments
  </Card>

  <Card title="Health" icon="medical">
    Doctor visits, checkups
  </Card>

  <Card title="Family" icon="people">
    Family events, gatherings
  </Card>

  <Card title="Finance" icon="cash">
    Bill payments, banking
  </Card>

  <Card title="Education" icon="school">
    Classes, exams, courses
  </Card>

  <Card title="Hobby" icon="game-controller">
    Sports, hobbies, activities
  </Card>

  <Card title="Shopping" icon="cart">
    Shopping trips, purchases
  </Card>

  <Card title="Travel" icon="airplane">
    Flights, trips, vacations
  </Card>

  <Card title="Food" icon="restaurant">
    Dining, reservations
  </Card>

  <Card title="Entertainment" icon="film">
    Movies, concerts, shows
  </Card>
</CardGroup>

### Advanced Features

#### Conflict Detection

Qwox automatically checks for scheduling conflicts:

* **Time Overlaps**: Warns if events overlap
* **Back-to-Back Events**: Alerts for no break between meetings
* **Busy Days**: Notifies when you have 3+ events in one day
* **Smart Suggestions**: Proposes alternative times

<Warning>
  Conflict detection runs in real-time as you type the event title and select the date.
</Warning>

#### Reminders

Set multiple reminders for each event:

* **At time of event**
* **5, 10, 15, 30 minutes before**
* **1, 2, 24 hours before**
* **1 day before**
* **Custom time**

**Notification Channels**:

* Push notifications (mobile)
* In-app notifications
* Email (coming soon)

#### Tags

Add custom tags for better organization:

* Type tag name and press Enter
* Multiple tags per event
* Filter timeline by tags
* Auto-suggestions from existing tags

#### Location

Add event location:

* Free-form text input
* Supports addresses, venue names, or descriptions
* Displayed in event details

#### Notes/Description

Add additional context:

* Meeting agenda
* Preparation notes
* Attendee information
* Any relevant details

#### Attendees

<Info>
  Attendee management is coming soon. You can add attendee names in the Notes field for now.
</Info>

## Editing Events

### From Timeline

1. Tap on any event card
2. View event details in modal
3. Tap "Edit" button
4. Make changes
5. Save

### From Chat

```text theme={null}
"Move my dentist appointment to Friday"
"Change the meeting time to 11am"
"Update the location for tomorrow's event"
```

## Deleting Events

### From Timeline

1. Tap on event card
2. Tap "Delete" button
3. Confirm deletion

### From Chat

```text theme={null}
"Cancel my dentist appointment"
"Delete the team meeting"
"Remove tomorrow's event"
```

## Platform Differences

### Mobile

* **Pull-to-Refresh**: Swipe down to reload timeline
* **Swipe Actions**: Swipe left on event for quick delete
* **Compact View**: Optimized for smaller screens
* **Touch Gestures**: Long-press for additional options

### Web

* **2-Column Layout**: More events visible at once
* **Hover States**: Preview event details on hover
* **Keyboard Navigation**: Arrow keys to navigate
* **Larger Modals**: More spacious event editing

## AI Features

### Smart Event Detection

Qwox analyzes your conversations and uploads to detect events:

* **Date Mentions**: "I have a meeting on Tuesday"
* **Time References**: "at 3pm", "tomorrow morning"
* **Event Keywords**: "appointment", "deadline", "birthday"
* **Document Scanning**: OCR from uploaded images/PDFs

### Category Prediction

AI suggests the most appropriate category based on:

* Event title keywords
* Time of day
* Your past event patterns
* Context from conversation

### Conflict Intelligence

Advanced conflict detection considers:

* Event duration (estimated from type)
* Travel time between locations
* Your typical schedule patterns
* Buffer time preferences

### AI Research & Multi-Step Planning

Qwox can perform complex, multi-step tasks by researching the web and combining information:

**Example 1: Business Meeting with Weather Context**

```text theme={null}
"I have a meeting in Istanbul tomorrow. Find out the weather forecast 
and tell me what I should wear. Then add the meeting to my calendar. 
Sales meeting: tomorrow at 2:00 PM in Avcılar, Istanbul. Include this 
information along with tomorrow's weather and clothing recommendations 
when adding this event to my calendar!"
```

**What Qwox does**:

1. 🌐 **Web Search**: Searches for Istanbul weather forecast
2. 🌤️ **Analysis**: Finds "Partly cloudy, around 14°C (57°F)"
3. 👔 **Recommendation**: Suggests "layers, such as a light jacket or sweater"
4. 📅 **Event Creation**: Creates event with all context in description:
   * Location: Avcılar, Istanbul
   * Weather: Partly cloudy, 14°C
   * Clothing: Light jacket or sweater recommended

**Example 2: International Business Trip**

```text theme={null}
"I'm meeting a client in Paris next week. Research the best business 
districts, check the weather, and create an event with travel tips."
```

**What Qwox does**:

1. 🌐 Researches Paris business districts (La Défense, Opéra, etc.)
2. 🌤️ Checks Paris weather forecast
3. 🚇 Finds transportation tips
4. 📅 Creates event with comprehensive context

**Example 3: Conference Preparation**

```text theme={null}
"I'm attending a tech conference in San Francisco. Find the venue address, 
check parking options, and add it to my calendar with all details."
```

**What Qwox does**:

1. 🌐 Searches for venue location
2. 🅿️ Researches nearby parking
3. 🚌 Finds public transport options
4. 📅 Creates event with complete logistics

<Tip>
  The more context you provide, the better Qwox can research and prepare your event details!
</Tip>

## Best Practices

<AccordionGroup>
  <Accordion title="Use Descriptive Titles" icon="heading">
    "Marketing Strategy Meeting with Sarah" is better than just "Meeting"
  </Accordion>

  <Accordion title="Set Multiple Reminders" icon="bell">
    For important events, set reminders at 1 day before AND 30 minutes before
  </Accordion>

  <Accordion title="Add Context in Notes" icon="note-sticky">
    Include agenda, preparation items, or links in the Notes field
  </Accordion>

  <Accordion title="Use Categories Consistently" icon="folder">
    Stick to the same categories for similar events to build patterns
  </Accordion>

  <Accordion title="Review Conflicts" icon="warning">
    Always check conflict warnings before confirming events
  </Accordion>

  <Accordion title="Upload Event Documents" icon="paperclip">
    Upload tickets, confirmations, or invitations for automatic event creation
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Event not showing in Timeline" icon="question">
    * Check if you're in the correct view mode (Past/Today/Upcoming/All)
    * Pull-to-refresh to sync latest data
    * Verify the event date is within the view range
  </Accordion>

  <Accordion title="OCR detection not working" icon="question">
    * Ensure the image/PDF contains clear date/time text
    * Try uploading a higher quality image
    * Check that the document is in a supported language
  </Accordion>

  <Accordion title="Reminders not firing" icon="question">
    * Enable push notifications in device settings
    * Check that the event time hasn't passed
    * Verify reminders were saved (edit event to check)
  </Accordion>
</AccordionGroup>

## Related Guides

<CardGroup cols={2}>
  <Card title="Memories" icon="brain" href="/guides/memories">
    Connect events with memories
  </Card>

  <Card title="AI Chat" icon="message-bot" href="/guides/ai-chat">
    Create events via conversation
  </Card>
</CardGroup>