> For the complete documentation index, see [llms.txt](https://adatrack.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://adatrack.gitbook.io/docs/documentation/features/dashboards.md).

# Dashboards

**Interactive Dashboards** allow you to create customized, real-time visual monitoring centers for your IoT fleet. Unlike standard pages, dashboards are modular and can be tailored to the specific needs of different stakeholders—from maintenance engineers to operation managers.

### Key Capabilities

* **Visual Builder:** Create and arrange widgets using a responsive, drag-and-drop grid.
* **Modular Widgets:** Choose from a library of gauges, charts, value cards, and live maps.
* **Real-Time Sync:** Widgets update instantly as new telemetry arrives via WebSockets.
* **Public Sharing:** Securely share dashboards with stakeholders via a unique, non-guessable URL.
* **External Embedding:** Integrate your AdaTrack dashboards into your own websites or 3rd-party portals using iframes.

### Widget Library

#### 1. Value Card

Displays the latest numeric or string value for a specific telemetry key (e.g., "Current Temperature: 24.5 °C").

#### 2. Gauge

A visual circular or linear gauge for monitoring thresholds. Ideal for battery levels, fuel tanks, or speed.

#### 3. Live Map

A lightweight version of the live tracking map, filtered to the specific devices associated with the dashboard.

#### 4. Trend Chart (Line/Bar)

Visualizes historical trends for one or more telemetry fields over a selected time range.

#### 5. Status Grid

Shows a high-level "Online/Offline" status for a group of devices, allowing for quick identification of connectivity issues.

#### 6. AI Chat *(requires AI Assistant plugin)*

An embedded AI chat panel that lets you ask natural-language questions about specific devices directly from a dashboard. Configure which device IDs the widget is aware of — the AI assistant automatically scopes its answers to those assets. Ideal for operational dashboards where you want instant AI-powered context alongside your live charts and maps.

### Building a Dashboard

1. Navigate to the **Dashboards** page and click **New Dashboard**.
2. **Add Widget:** Click the "+" button to open the component library.
3. **Configure Widget:**
   * **Data Source:** Select the devices or profile to monitor.
   * **Telemetry Key:** Choose the specific field (e.g., `humidity`).
   * **Style:** Set labels, colors, and units (e.g., "%", "V", "°C").
4. **Arrange:** Drag and resize widgets on the grid to create your desired layout.
5. **Save:** Click save to persist your dashboard.

### Sharing & Security

AdaTrack provides multiple ways to share your dashboards:

* **Private (Default):** Only you and authorized members of your organization can view the dashboard.
* **Public Link:** Generate a unique URL that allows anyone with the link to view the dashboard without logging in.
* **Embedded:** Use the provided Iframe code to place the dashboard inside another application or website.

**Security Note:** Public dashboards use a "Scoped Read-Only API." This ensures that even with a public link, visitors can *only* see the specific telemetry fields you've added to the dashboard widgets. They cannot access your full device history or system settings.

### Responsive Layouts (Desktop, Tablet, Mobile)

Dashboards support independent widget layouts for **desktop**, **tablet**, and **mobile** screen sizes. Use the breakpoint switcher in the dashboard editor to preview and fine-tune each size individually — resize or hide widgets differently on mobile than on your operations-center monitor. If you haven't customized a smaller breakpoint yet, AdaTrack automatically cascades your desktop layout down to it, so tablets and phones get a sensible layout by default without any extra work.

The **Live Map** widget can also be expanded to a fullscreen view from any dashboard — useful when you need a closer look without leaving the page.

### Technical Details

* **Responsive Layout:** Dashboards use a 12-column responsive grid that adapts to different screen sizes, including mobile tablets and large operation center monitors.
* **Data Caching:** To ensure high performance, dashboard layouts can be snapshotted to static manifests, while telemetry data is fetched via a lightweight, optimized API.
* **Scalability:** Public and embedded dashboards are designed to handle high traffic without impacting the performance of the core tracking platform.

### Best Practices

* **Group by Function:** Create separate dashboards for different purposes (e.g., "Battery Health Overview" vs. "Real-time Location Monitor").
* **Mind the Density:** Don't overcrowd a single dashboard. Aim for 4-8 high-impact widgets per view.
* **Use Consistent Units:** Ensure all widgets on a single dashboard use the same unit system (Metric vs. Imperial) to avoid confusion.