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

# Sync Behavior

How LinCal stays in sync with Linear and when data is refreshed.

## Actions Sync Instantly

When you make changes in LinCal — creating a task, dragging to reschedule, updating status, assignee, or other properties — those changes are sent to Linear immediately. The UI updates right away (optimistic updates), and Linear is updated in the background. If a change fails, you'll see an error and the affected area will refresh from Linear.

## When Does Data Refresh Automatically?

You usually don't need to press Sync when you're actively using the app:

* **After each action** — Creating a task, editing one, or dragging it to a new date triggers a refresh of the affected area (that month, or the tasks-without-due-date list).
* **When scrolling back** — If you scroll to a month you haven't viewed in over 5 minutes, that month's data is refreshed when it becomes visible again.
* **When returning to the tab** — If you've been away for 5 minutes or more, data refreshes automatically when you come back.

**When to use Sync:** Use the Sync button when you've been viewing the calendar without making changes and want to pull in the latest updates from Linear or your teammates.

## What Happens When You Scroll

The calendar loads data **on demand** as you scroll:

* Tasks are fetched **per calendar month**.
* When you scroll into a new month, that month's tasks are loaded when the first day of that month enters the visible area.
* Previously loaded months are cached for about 5 minutes, so scrolling back is fast.

This keeps the app responsive while you move through the calendar.

## Manual Sync

Use the Sync button in the display menu to refresh all data at any time. The button is disabled while a sync is in progress.