# User Guide

#### Opening the Dashboard

Access Dashly from the Unity menu:

```
Tools > Latin Tools > ☰ Dashly Dashboard
```

***

#### Creating Categories

**Method 1: Using Setup Screen**

1. Click the **Settings icon (⚙️)** in the header
2. Click **"➕ Add Category"**
3. Choose a save location and name
4. The category is automatically added to your configuration

**Method 2: Creating Manually**

1. In Project window: `Right-click > Create > Latin Tools > Dashly > Category`
2. Open the DashlyConfiguration asset
3. Add your category to the **Categories** list
4. Save the configuration

**Configuring Categories**

Each category can be customized with:

* **Name**: Displayed in the sidebar
* **Icon**: Use any emoji (📦, ⚙️, 👥, 🎮, etc.)
* **Description**: Additional context (optional)
* **Sections**: Content organization

**Preset Emoji Icons:**

* 📦 Inventory/Items
* ⚙️ Settings/Configuration
* 👥 Characters/NPCs
* 🎮 Game Mechanics
* 🎨 Visual/Art Assets
* 🔊 Audio/Sound
* 🗺️ Levels/Maps
* 📊 Analytics/Data

***

#### Managing Sections

Sections help organize ScriptableObjects within a category.

**Adding a Section**

1. Select a category asset in the inspector
2. Scroll to **Content Sections**
3. Click **"➕ Add Section"**
4. Name your section
5. The section appears collapsed by default

**Editing Sections**

Click the **▶** arrow next to a section to expand it and:

* Rename the section
* Add/remove ScriptableObjects
* Reorder items

**Reordering Sections**

Use the **drag handle (⋮⋮)** on the left side of each section to reorder them via drag-and-drop.

**Deleting Sections**

Click the **"✕ Remove"** button on the section header. You'll be prompted to confirm the deletion.

***

#### Adding ScriptableObjects

<div data-full-width="true" data-with-frame="true"><figure><img src="https://3907550989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYH8zSxn3d9Ari1ugSpaO%2Fuploads%2FO95YCyuzs7yuViFPdm8g%2Fimage.png?alt=media&#x26;token=2d4bb258-919f-4995-aa80-9b47706c51c7" alt=""><figcaption></figcaption></figure></div>

There are three ways to add ScriptableObjects to a section:

**1. Drag & Drop (Recommended)**

1. Expand a section in the category editor
2. Drag ScriptableObject(s) from the Project window
3. Drop them into the **🎯 Drop Area**
4. Multiple objects can be added at once

<div data-with-frame="true"><figure><img src="https://3907550989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYH8zSxn3d9Ari1ugSpaO%2Fuploads%2FZkZ5s0Z9DdyQmRxkqCui%2Fimage.png?alt=media&#x26;token=649e0f6b-1451-4faa-b6b9-c0f29fbc7322" alt=""><figcaption></figcaption></figure></div>

**2. Manual Selection**

1. Expand a section
2. Click **"+ Add ScriptableObject"**
3. Use the object picker to select an asset
4. Repeat for additional objects

**3. Direct Assignment**

1. Expand a section
2. Click on an empty object field
3. Select the ScriptableObject from the picker

**Managing ScriptableObjects**

For each ScriptableObject in a section, you can:

* **📍 Focus** - Highlight the asset in the Project window
* **🗑️ Remove** - Remove from the section (doesn't delete the asset)
* **View Details** - See the object's properties inline

***

#### Customizing Appearance

<div data-with-frame="true"><figure><img src="https://3907550989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYH8zSxn3d9Ari1ugSpaO%2Fuploads%2FYQ3Feqkc6RBO1pTzawox%2Fimage.png?alt=media&#x26;token=2a95b39f-c0d0-4620-b2be-e8bbba76a1fa" alt=""><figcaption></figcaption></figure></div>

Dashly supports full theme customization through the Preferences system.

**Theme Settings**

**Color Theme:**

* Primary Color (main background)
* Secondary Color (sidebar/header)

**Layout Settings:**

* Sidebar Width (180-300px)
* Header Height (40-60px)
* Content Margin (8-32px)

**Applying Preferences**

1. Configure your preferences asset
2. Click **"Apply Preferences"**
3. Changes take effect immediately

**Resetting to Defaults**

Click **"Reset to Defaults"** in the Preferences screen to restore the original theme.

***

### 🔥 Advanced Features

#### Multi-tab Support

<div data-with-frame="true"><figure><img src="https://3907550989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYH8zSxn3d9Ari1ugSpaO%2Fuploads%2F3xSI1qubzo3j4AWfvrMt%2Fimage.png?alt=media&#x26;token=42ba2dda-023c-4974-ad3b-9a49030aaafb" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://3907550989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYH8zSxn3d9Ari1ugSpaO%2Fuploads%2FZx4ejCYQtAe8e7KGoRMr%2Fimage.png?alt=media&#x26;token=e975111e-8f33-4d23-80cd-3e51ea2847b3" alt=""><figcaption></figcaption></figure></div>

Work with multiple categories simultaneously:

* **Open in Tab**: Right-click a category > "Open in New Tab"
* **Switch Tabs**: Click tab headers or use `Ctrl+Tab` / `Ctrl+Shift+Tab`
* **Close Tab**: Click the **✕** on the tab or right-click > "Close Tab"
* **Close Others**: Right-click a tab > "Close Other Tabs"
* **Duplicate Tab**: Right-click a tab > "Duplicate Tab"

#### Search Functionality

<div data-with-frame="true"><figure><img src="https://3907550989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYH8zSxn3d9Ari1ugSpaO%2Fuploads%2FAuuha3RZQbZY7GDAAJNh%2Fimage.png?alt=media&#x26;token=f260cec1-f13f-43a2-9f78-2dc91a6acd36" alt=""><figcaption></figcaption></figure></div>

Quickly find categories and sections:

1. Click the **🔍 Search** button in the sidebar header
2. Type your search query
3. Matching categories and sections are highlighted
4. Non-matching items are hidden
5. Click **🔍** again or clear the search to show all

**Search Highlights:**

* Yellow background indicates matches
* Section navigators expand automatically for matches

#### Section Navigator

<div data-with-frame="true"><figure><img src="https://3907550989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYH8zSxn3d9Ari1ugSpaO%2Fuploads%2F5kVcVMGIT15lRmwAdYRg%2Fimage.png?alt=media&#x26;token=0ef1a25c-1fa5-4dca-8dd3-c9542906a15a" alt=""><figcaption></figcaption></figure></div>

When viewing a category with multiple sections:

1. The **Section Navigator** appears below the selected category
2. Click section names to jump directly to that section
3. Content scrolls smoothly to the selected section

#### Sidebar Toggle

Maximize your workspace:

* Click **<** button in sidebar header to collapse
* Click **☰** button in main header to expand
* Sidebar state persists during the session

#### Drag & Drop Reordering

<div data-with-frame="true"><figure><img src="https://3907550989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYH8zSxn3d9Ari1ugSpaO%2Fuploads%2FKJnE3XpzbYtamogmsXYQ%2Fimage.png?alt=media&#x26;token=c1908f14-840e-40da-ac19-5ee2ab324ad7" alt=""><figcaption></figcaption></figure></div>

**Categories:**

* In the Configuration editor, drag the **⋮⋮** handle to reorder categories
* Order reflects in the dashboard sidebar

**Sections:**

* In the Category editor, drag the **⋮⋮** handle to reorder sections
* Order reflects in the dashboard content area

#### Welcome Screen

* Shows on first launch or when clicking "DASHLY" in the sidebar
* Toggle "Show at startup" to control visibility
* Access documentation, support, and setup from here

***

### ⌨️ Keyboard Shortcuts

| Shortcut             | Action                 |
| -------------------- | ---------------------- |
| `Ctrl + Tab`         | Switch to next tab     |
| `Ctrl + Shift + Tab` | Switch to previous tab |
| `Tab`                | Switch sidebar         |

***
