> For the complete documentation index, see [llms.txt](https://docs.infotopics.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.infotopics.com/trulyp/analytics/create-an-app.md).

# Create an app

### Creating your app

#### Connecting a datasource

<figure><img src="https://2312557015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbWxEBax8PKTjFYRLWgi%2Fuploads%2FsdKnGUlRzam6Xve2Ev5n%2FAnalytics_Create_Connect_Data_Source_Step1.png?alt=media&amp;token=425d6744-201a-4697-bf35-26f4c507e669" alt=""><figcaption></figcaption></figure>

When you open your new Analytics app, you will first be asked to connect to a datasource. The datasources available to you, is dependent on what [Teams](/trulyp/members-teams-and-roles/teams.md) you are in. Click **Connect** on the datasource you want to use, after which you can press **Done** to continue to Analytics.

<figure><img src="https://2312557015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbWxEBax8PKTjFYRLWgi%2Fuploads%2FqFwhYbDrV62xsqxtJbXh%2Fimage.png?alt=media&amp;token=04a2aad1-9f96-49be-b261-c315dff13d16" alt=""><figcaption></figcaption></figure>

#### Designing the dashboard

You are now ready to start creating your app! On the right side, drag in any of the visuals you would like to show. For this example, we will use the **Cartesian - Bar** visual.

<figure><img src="https://2312557015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbWxEBax8PKTjFYRLWgi%2Fuploads%2F0ZlKY6MdxIEZOB8RQgGA%2Fimage.png?alt=media&amp;token=80952cb6-bb19-4bf9-bc3c-2fdfe11af0e4" alt=""><figcaption></figcaption></figure>

When you have placed the visual on the dashboard, you will see the metrics and values you can use for this visual. Here, we will drag **Category** and **Delivery mode** to the X-axis, and **Quantity** to the Y axis. The visual will then look like this:

<figure><img src="https://2312557015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbWxEBax8PKTjFYRLWgi%2Fuploads%2FkQ4wodCc8xlbgLHQ6EWJ%2FAnalytics_Create_Add_Visual.png?alt=media&amp;token=ed1af402-8286-485d-a68c-29a4c53f6fe6" alt=""><figcaption></figcaption></figure>

<div><figure><img src="https://2312557015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbWxEBax8PKTjFYRLWgi%2Fuploads%2Flw7Q1uPKX4mzsbTMSl2d%2Fimage.png?alt=media&amp;token=d00811ff-04c6-44cb-b63f-cf0ad07a2d41" alt="" width="284"><figcaption></figcaption></figure> <figure><img src="https://2312557015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbWxEBax8PKTjFYRLWgi%2Fuploads%2Fg7PtPvn2SsK9jeVE4Kcj%2Fimage.png?alt=media&amp;token=52223199-527b-48e7-adc2-9ac4861e952b" alt="" width="318"><figcaption></figcaption></figure></div>

After adding the data, you can also change the way data is sorted, and how the data on the Y axis is calculated, for example changing from **SUM** to **COUNT**.

For this example, we will alos add a **Donut** and **Map visual,** setting them up the same way as we did the **Bar** chart.

<figure><img src="https://2312557015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbWxEBax8PKTjFYRLWgi%2Fuploads%2FOGkDVVBPnX7ItCgNB1j5%2F6Analytics_Create_App.png?alt=media&amp;token=29c48d79-d8be-469d-99ed-a8ed2804d466" alt=""><figcaption></figcaption></figure>

### Viewing, filtering and interacting with your app

Now that your app is finished, you can click the eye icon in the hotbar to exit **edit** mode, and see the dashboard like any other user. Analytics dashboards are **interactable,** for example, we can filter simply by clicking on the Office supplies in the bar chart:

<figure><img src="https://2312557015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbWxEBax8PKTjFYRLWgi%2Fuploads%2FhgUYNSHWm5dpW5o1KrlX%2FAnalytics_Create_App_Filter.png?alt=media&amp;token=a6fab9b4-2e49-4be5-a531-3222a8361319" alt=""><figcaption></figcaption></figure>

Of course, the same also works if you click on furniture in the Donut chart. To clear **one, multiple or all** filters, click on the filter icon in the hot bar.

<figure><img src="https://2312557015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbWxEBax8PKTjFYRLWgi%2Fuploads%2Fci8tuyofRPNYAXd2VmNV%2FAnalytics_Create_App_Filter_Zoomed.png?alt=media&amp;token=45d6930e-4a95-4651-80f5-d7493319bbec" alt=""><figcaption></figcaption></figure>

#### Sharing your app

&#x20;![](https://2312557015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbWxEBax8PKTjFYRLWgi%2Fuploads%2FJVyP2Yxg6QkS5emdFrtu%2Fimage.png?alt=media\&token=1302f041-c2f8-400c-8266-84a512ab09ca) You can also share your app with other users through the share button. You can then choose another Trulyp user with whom to share the dashboard.

You can press the cogwheel in the hotbar to open the [Global chart options](/trulyp/analytics/global-chart-options.md), from where you can change the look and feel of your charts!

<figure><img src="https://2312557015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbWxEBax8PKTjFYRLWgi%2Fuploads%2FTQDuvJF8XEKzEdaU2fXx%2FAnalytics_Create_App_Share_Dashboard.png?alt=media&amp;token=f453ca86-c60e-47d5-8986-2ddeca2102dd" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.infotopics.com/trulyp/analytics/create-an-app.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
