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

# Notifications

> Real-time notifications and activity tracking in Eyesotope

# Notifications

Eyesotope delivers real-time notifications to keep you informed about activities across your farm, using a dual-channel system: **WebSocket** for instant delivery and **REST polling** as a fallback.

## Notification Types

You'll receive notifications for events such as:

* **Field changes** — When fields are created, updated, deleted, archived, or restored
* **Season updates** — New seasons, field assignments, crop changes
* **Team changes** — New members joining, role changes, invitations
* **Operations** — Operation creation, updates, and completion
* **Inventory** — Stock level changes, new products added
* **Equipment** — Equipment status updates, maintenance events
* **Contracts & Deliveries** — New agreements, shipment updates
* **System alerts** — Important platform announcements

## Notification Panel

Click the **bell icon** 🔔 in the top navigation bar to open the notification panel:

* **Unread badge** — Shows the number of unread notifications (displays "99+" for large counts), includes pending team invitations in the count
* **Filter tabs** — Switch between **All** and **Unread** notifications
* **Mark all as read** — Clear all unread indicators with one click
* **Infinite scroll** — Loads more notifications as you scroll down
* **Click to navigate** — Click any notification to go to the related item

### Notification Details

Each notification shows:

* **Actor avatar** — Profile photo or initials of who performed the action
* **Action text** — What happened (e.g., "created a field", "updated an operation")
* **Description** — Additional context (truncated for long text)
* **Relative time** — "Just now", "5 minutes ago", "2 hours ago", etc.
* **Unread dot** — Blue indicator for unread notifications

### Priority Levels

| Priority | Style       | Use Case                        |
| -------- | ----------- | ------------------------------- |
| Critical | Red accent  | System alerts, errors           |
| Normal   | Blue accent | Standard activity notifications |
| Low      | Gray/ghost  | Minor updates                   |

### Team Invitations

Pending team invitations appear inline within the notification panel with **Accept** and **Decline** action buttons, so you can respond without navigating away.

## Real-Time Delivery

Notifications are delivered via **WebSocket** for instant updates:

* Automatic reconnection with exponential backoff if the connection drops
* Keepalive pings every 25 seconds to maintain the connection
* Falls back to REST polling (every 15 seconds) if WebSocket is unavailable
* Reconnects automatically when you switch browser tabs

## Activity Log

The **Activity Log** page provides a complete audit trail of all actions across your farm:

1. Navigate to **Activity** in the left sidebar
2. View a chronological list of all actions: created, updated, deleted, archived, and restored
3. Covers 30+ entity types — seasons, crops, fields, equipment, contracts, deliveries, operations, partners, leases, sites, and more
4. Each entry shows who performed the action, what changed, and when

<Info>
  The Activity Log records every CRUD operation across the farm. It's useful for auditing team actions, tracking changes, and understanding the history of any entity.
</Info>

## Notification Context

Notifications include contextual information such as:

* The farm and season the event relates to
* The specific field, area, and crop affected
* Who performed the action
* Timestamps

<Tip>
  Notifications are farm-specific. You'll only see notifications for your currently active farm. Switch farms to view notifications for other farms.
</Tip>