> ## Documentation Index
> Fetch the complete documentation index at: https://docs.luklak.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Building Your First Dashboard
> A step-by-step tutorial on how to create a new Dashboard, add and configure gadgets, and set up data sources to visualize your business insights.
## Before You Begin
This tutorial will walk you through the process of building a simple "Sales Performance" dashboard from scratch.
**Prerequisite:** This guide assumes you have a `Function` (e.g., "Sales CRM") and a `Space` with some sample `🧊 Deal` Objects. Your `Deal` Object Type should have fields like `Deal Value` (Number), `Stage` (Select List), and `Owner` (User).
Remember, a **Dashboard** is for **analysis**. We are now going to aggregate the data from many individual `🧊 Deal` Objects to see the big picture.
## The 3 Levels of Data Scoping
Before building, it's important to understand how Luklak handles data sources. You can define a data scope at three cascading levels:
1. **Dashboard-Level Source:** Set a default data source for the **entire dashboard** (e.g., "All data from the Sales CRM Function").
2. **Page-Level Source:** Override the dashboard source for a **specific page** (e.g., "Page 2 only shows data from the Enterprise Deals Space").
3. **Gadget-Level Source:** Override all other sources for a **single gadget**.
For maximum flexibility, most users set data sources at the **Gadget Level**. This allows you to have a gadget for "Sales Deals" right next to a gadget for "Support Tickets" on the same page. This tutorial will follow that approach.
## Step-by-Step Guide: Building a Sales Dashboard
```guidejar theme={null}
# Building a Sales Performance Dashboard
This guide walks you through creating a simple dashboard with two common gadgets: a Counter and a Pie Chart.
## Section 1: Create Your New Dashboard
1. Navigate to the main **Dashboards** area in your sidebar.
2. Click the **'+ New Dashboard'** button.
3. Give your dashboard a name, like "Sales Performance Q3", and click **'Create'**.
* You will be taken to a new, empty dashboard canvas, ready for your gadgets.
## Section 2: Add a 'Deal Count' Counter
* Tip: Counters are great for showing a single, important, at-a-glance number.
1. On the empty canvas, click **'+ Add Gadget'**.
2. Select the **'Counter'** gadget from the library.
3. In the gadget's configuration panel, set the **Data Source**. Use UQL to define what you want to count.
* For this example, let's count all open deals: `object.type = "Deal" AND status.category = "ACTIVE"`
4. Give the gadget a title: "Total Active Deals".
5. Click **'Save'**. The counter will appear on your dashboard.
## Section 3: Add a 'Pipeline Stage' Pie Chart
* Tip: Pie charts are perfect for showing the proportional breakdown of your data.
1. Click **'+ Add Gadget'** again.
2. Select the **'Chart'** gadget and choose the **'Pie'** type.
3. Set the **Data Source** to count all your active deals: `object.type = "Deal" AND status.category = "ACTIVE"`
4. In the **'Group By'** setting, select your 'Stage' field (`stage`). This tells the chart how to slice the pie.
5. Give the gadget a title: "Active Pipeline by Stage".
6. Click **'Save'**.
## Section 4: Arrange Your Dashboard
1. You can now **drag and drop** your gadgets on the canvas to arrange them.
2. You can also **resize** them by dragging their corners to get the perfect layout.
```
## What's Next?
You've successfully built a basic dashboard. The next step is to learn how to use filters and drill-downs to explore your data interactively.
* [**Learn how to make your dashboards dynamic: Using Interactive Dashboards**](/en/02-platform/platform-overview/dashboards/interactive-dashboards)
* [**Return to the Dashboards Overview**](/en/02-platform/platform-overview/dashboards)