The Building Blocks of Your Dashboard
A gadget is a specific, configurable widget that you place on your dashboard to visualize a set of data. Your dashboard is a canvas, and gadgets are the powerful tools you use to paint your data story. This guide serves as a reference library for all the standard gadget types available in Luklak, explaining the purpose and best use case for each.Charts
Charts are the best way to visualize proportions, comparisons, and trends in your data. You typically configure a chart by grouping your🧊 Objects
by a Select List
, User
, or Status
field.
Best for: Showing proportions and the percentage breakdown of a whole.
Business Question: “What is the breakdown of our sales pipeline by
Business Question: “What is the breakdown of our sales pipeline by
Stage
?” or “What percentage of our support tickets are High Priority
?”Statistics Tables
Statistics Tables are powerful tools for creating summary reports in a pivot-table-like format. They are ideal for analyzing the distribution of work across two dimensions.- 1D Statistics Table: Groups
🧊 Objects
by one criterion to create a simple summary table.- Business Question: “Show me a count of all
Support Tickets
, grouped by theirStatus
.”
- Business Question: “Show me a count of all
- 2D Statistics Table: Groups
🧊 Objects
by two criteria simultaneously, creating a matrix.- Business Question: “Show me a count of all
Support Tickets
, withPriority
as the rows andAssignee
as the columns. This helps identify if one person is overloaded with high-priority tickets.”
- Business Question: “Show me a count of all
Counters & Formulas
This gadget is for displaying a single, important number or calculated result.- Counter: The simplest gadget. It displays a real-time count of
🧊 Objects
that match your UQL query.- Use Case: A large number showing the “Total Open Bugs” or “Deals Closed This Quarter.”
- Formula: Allows you to perform calculations on aggregated data.
- Use Case: Use two different counters to calculate a conversion rate:
(Count of 'Deals Won' / Count of 'All Deals') * 100
to show your overall “Win Rate %”.
- Use Case: Use two different counters to calculate a conversion rate:
Object List
Sometimes the most important thing is not a chart, but a direct view of the work itself. This gadget allows you to embed a filtered list of key🧊 Objects
directly onto your dashboard.
- Use Case: On a Project Manager’s dashboard, alongside charts showing overall progress, include an
Object List
gadget that shows “All🧊 Tasks
with aStatus
ofBLOCKED
” for immediate action.
Activity Feed
This gadget embeds a real-time activity stream from a selected data source directly into your dashboard view, allowing users to track updates and take action in real time.- Use Case: On a team’s dashboard, include an
Activity Feed
for their specific⏹️ Space
so everyone can see the latest comments, status changes, and file attachments without leaving the dashboard.