# Dashboard

We call it the "dashboard" because it presents a good **summary of user information** and is where the user begins their relationship with the app. For example, they can easily see quickly if their last activity has been **synchronized** well, add a **new activity**, check **the status** of the challenges in which they are registered (Ongoing challenges section), check the number of **points** or **credits** they've earned, their **team position** in the ranking and more.

![Different example of dashboard screens](/files/-MVziJU_S1wwEBPMNm5Q)

{% hint style="info" %}
**Discover our challenges:** When the user isn't registered in any challenge a banner will be displayed to invite user to enroll to their next challenge. *(Example in the middle of the above image)*
{% endhint %}

{% hint style="info" %}
**Enter the Arena:** In the case of the ranking feature is not mandatory in your app, a banner will be displayed to invite users to take part in the ranking. *(Example in the right of the above image)*
{% endhint %}

#### No app connected

When users have finished their onboarding and if they have not connected any sport applications during the onboarding, the dashboard will then be exclusively dedicated to connecting a sport application. With an image (**500x500 pixels, .jpg**, **.png**) to illustrate the fact that users should connect a sport application to have a good experience with the app. A title and a description to explain to a user why we need this and below, the list of all compatible applications that the user can connect.

![](/files/-MVuoOInsOgwiD5GFjUd)

#### No activity

When they have successfully connected a compatible application to recover their sports activities, we display an image (**500x500 pixels, .jpg**, **.png**) and a text to motivate users to perform their first activity.&#x20;

![](/files/-MVuoJfgxHI7N2NGNVtE)

### Data info

![](/files/-MW5KRVuXdcCcRPLQQcM)

You can customize the **data information blocks** to prioritize the two data key relatives to your app. (View image above with 3 examples)

### Feed

#### Activities

You can customise the background color of each activity. The color you choose for the circle background of the activity icon on the dasboard will be the same as those displayed on the user's profile.

![All activities available](/files/-MVuj3VPvff78k-6JdHF)

![Colors of the activities dashboard icons seen on dashboard datas are used on the profile datas.](/files/-MVumBFTFvnH8s1EnLB3)

If you already have your own activities icons (*example: We already have our own icon dedicated for running activity*) you can use it on your application if you provide us your icon(s) in **.svg** format. This icon must keep a perfect reading level in small size (16x16 pixels, 24x24 pixels).

#### Activity detail

When users tap on an activity they have access to **more detail** about it. They have access to: **Additional data**, from where the activity came from (**app provider**), and the **date**. If the activity is not taken into account, an **error message** will explain to the user why his activity is not valid. They also can **delete** the activity.

![](/files/-MW-fCKhCXt2npBpPKtF)

#### Challenges

When a user **completes a challenge**, an event will be displayed on their dashboard to inform them that they've achieve the goal of the challenge. They may also have shortcuts to some actions linked to a certain type of challenge (example: For an Instant Win Challenge, you'll have the "See If I Won" button or you'll have access to the report of the race if you complete a race challenge). When you click on these events you will be redirected to the challenge detail page.

![Challenge events changes depending on the challenge type.](/files/-MVzdW8QR0jkFfvdYV5T)

{% hint style="info" %}
**Bonus challenge:** For all types of challenges you can define a bonus that all finishers of this challenge will earn. You can choose how many points you want to give to all finishers of each challenge.
{% endhint %}

#### Rewards

When a user **redeems a reward**, an event will be displayed on their dashboard to inform them that a reward has been redeemed. When you click on this event you will be redirected to the reward detail page.

![](/files/-MVzxMXs-ehaVGgDa-i_)

###

#### Teams

When a user **joins or leaves a team**, a message will be displayed on their dashboard to inform them that this modification has been done well. **Every month** an event will inform them of the final position of their team (for example on the image below "Ranking for February").

![](/files/-MVzyg-fpqjloG8cuLHS)

###

### Create an activity

Users can **create activities manually** to add activity where an activity is difficult to create on a tracking app or simply to allow them to participate even if they don't have a watch or another app. Depending on the activity type being added some fields will be requested: **Date**, **Duration** and/or **Distance**.

![](/files/-MW-aESmAXHbMPHA3Ghu)

{% hint style="warning" %}
You can only manually add activities by using the app. Our web app doesn't include this feature at this moment.
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://docs.sportheroes.com/dashboard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
