---
title: "Library App Template"
slug: "lean-dashboard-widgets"
updated: 2026-04-23T14:11:16Z
published: 2026-04-23T14:11:16Z
---

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

# Lean Dashboard Widgets

To download, visit: [Library](https://library.tulip.co/apps/lean-dashboard-widget).

*Visualize cell performance across 5 key KPIS (People, Safety, Quality, Delivery, and Cost).*

Replace traditional paper-based shift dashboards with the lean dashboard Widget.

![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%2852%29.png)

## Overview

Use this Widget as a quick reference to visualize cell performance, typically on a large dashboard screen or touch screen. Operators or supervisors can update the status for the day by clicking the widget, with green indicating a good result and red indicating a poor result.

Data is stored in a table for historical reference. It allows one board to show multiple locations as well as data for multiple months.

The lean dashboard widget enables full historical data capture for future trends and root-cause problem solving. It allows for cross-cell and cross-plant transparency without additional manual consolidation of data.

Each letter shows the days for the selected month (future days are gray). The widget displays a green for a good day and red for a poor day. The widget doesn't define tolerences for good or bad; this will need to be defined by the app builder as part of the solution design. The click interaction of the widget can be disabled.

![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%2853%29.png)

## Setup

### Props

| Prop | type | Description | Config notes |
| --- | --- | --- | --- |
| INCIDENTS | text | The values that will be displayed. String of “Y” and “N” characters. One character per day. Y = green. N = red | If value is Null, the widget will default to a string of “N” of the right length for the month selected |
| MONTH | Datetime | A datetime in the month that you want the widget to be configured for | Future days will be disabled and colored grey |
| LOCATION | text | The location that the data coresponds to | Displayed in the widget title |
| PREVENT UPDATES | Boolean | To disable the click action from updating the **Incidents** prop | A click event is still generated |

### Events

| Events | Type | Description | Config notes |
| --- | --- | --- | --- |
| clicked | text | Returns the day clicked as an event | Could be used as a config message or to update an external data base |
| error | text | Returns the text of error events if and when the error occurs |  |

You can configure these widgets to other letters and shapes as you see fit.

## Further Reading

- Get help with set up and share what you are building with a community of custom widget builders: [Tulip Community Custom Widgets](https://community.tulip.co/c/custom-widgets/21)
- Learn how to build your own widget or customize existing custom widgets: [Custom Widgets Overview](/r230/docs/custom-widgets-overview-1)

---

Did you find what you were looking for?

You can also head to [community.tulip.co](https://community.tulip.co) to post your question or see if others have faced a similar question!

**Widget**

**Widgets**are the elements that make up a specific **App Step.**Widgets can display information to users, collect user input, or trigger app logic.

*Common widgets include: Interactive Tables, Number inputs, Machine attribute widgets, and more.*

**Datetime**

**Datetimes**are a Tulip Datatype. Datetimes represent a time in the ISO8601 format.

*ex. 2022-08-31T19:56:16+00:00*

**Boolean**

**Boolean's**are a Tulip Datatype. Booleans can have True/False (Yes/No) values.

**Events**

**Events**are **Triggers**fired by Custom **Widgets.**Users can configure as many Events as they want, and events can carry a payload of data to be used in a **Trigger.**