# V3 Gamification widget layout

<figure><img src="/files/bhi3JWPOSXsWuXBHYwBl" alt=""><figcaption><p>GF Widget V3 Layout example</p></figcaption></figure>

**Reference image package for V3:**

{% embed url="<https://libs.smartico.ai/gf/widget_images.zip>" %}

{% hint style="success" %}
You will need to provide the package with exactly the same names of files and sizes of the images.
{% endhint %}

#### Step by Step reference Videos

We have created these videos for you explaining how the full process works from beginning (using the Figma template) to end (delivering the required documents for implementation):

{% hint style="info" %}
You can switch the audio to another language by clicking the 'Settings' icon ⚙️ on the video and selecting your preferred language.
{% endhint %}

1. **How to edit images?**

{% embed url="<https://vimeo.com/1101260409>" %}

2. **How to edit Colors?**

{% embed url="<https://vimeo.com/1101260320>" %}

3. **How to export from Figma Color Template?**

{% embed url="<https://vimeo.com/1101260208>" %}

4. **Validating the Skin Package**

{% embed url="<https://vimeo.com/1101260166>" %}

5. **Saving a local copy of the Figma file**

{% embed url="<https://vimeo.com/1174429518>" %}

6. **Sharing the skin with the Smartico Team**

{% embed url="<https://vimeo.com/1173384972>" %}

#### **How to work with the Figma file**

* **Sections in the file**

<figure><img src="/files/DFQ6Ot0aO1cGKcmlN8YA" alt=""><figcaption></figcaption></figure>

**`1*`** Replace images Section - This is the only section you can edit\
\&#xNAN;**`2*`** Preview Section - Locked by default, shows how your changes will look<br>

* **Edit images**

1. Go to the Replace images section:

<figure><img src="/files/AV9BHnbZa6FAvpj3SOv0" alt=""><figcaption></figcaption></figure>

2. Use CMD/CTRL + click to select the image inside a component (it works similar to the direct selection tool from Illustrator)
3. Edit or replace the image inside the component (parent) - changes will show live in the Preview Section (children)
   1. ⚠️ By changing the images inside the components in this 'Replace images' Section, you will also be able to see how they change inside the widget screens (in the 'Preview' Section).

<div><figure><img src="/files/nxb2F4dchOdkx4V0rgqa" alt=""><figcaption></figcaption></figure> <figure><img src="/files/48yqLl3E7FXQ1nfxjmmU" alt=""><figcaption></figcaption></figure></div>

{% hint style="success" %}

* Use high-quality images or vectors to avoid pixelation

* If you want to keep Smartico’s default images, no changes are needed, but you will still need to provide us with the file
  {% endhint %}

* **Edit colors**

Colors can be updated in the Styles panel on the right sidebar in the Replace images section

<figure><img src="/files/YPhuEyIsjYE3lwzZucNJ" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}

* Detaching, swapping, or adding styles or components.
* Editing colors that are set as plain values (only styles can be edited).

Any of the actions described above might result on our team declining the changes you made and requesting you another delivery
{% endhint %}

* **Export images**

1. Select all components in the Replace images section
2. Click Export in the right sidebar
3. Use default settings (1x PNG)
4. Click Export layers and save the images

<figure><img src="/files/6ovgX4yDmmNtgHEIeIVG" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
By default all the exported components will be inside a folder, please do not change anything inside (naming, adding/deleting elements, changing the location they’ll be exported to by default, etc) all of these might result in the folder not being approved.
{% endhint %}

* **Validate the components exported**

1. Go to the Validator tool: <https://expo.smartico.ai/validate>
2. Choose a version (V3 or V4) - in this case V3
3. Upload your exported image folder
4. Check that all files and sizes are correct, this is the message you should expect

<figure><img src="/files/lVe9ZPHn2xUqBD9dFuVO" alt=""><figcaption></figcaption></figure>

* **Sharing with the Smartico Team**

1. Please save locally the Figma you just created

<figure><img src="/files/rdWu1MIstGXJoiqebvoK" alt=""><figcaption></figcaption></figure>

2. After exporting, you will get a “.fig” file like this:

<figure><img src="/files/1tkazVc05mftYh77PRp0" alt=""><figcaption></figcaption></figure>

3. Open a Jira ticket and add the exported Figma inside
4. Attach archive with the package folder in the Jira ticket (if images should be changed, if not we will use the fall back icons, the ones you can see inside the template)


---

# 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://help.smartico.ai/welcome/products/gamification-basics/gamification-ui-skinning/v3-gamification-widget-layout.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.
