Health Dashboard¶
The Health Dashboard provides an at-a-glance view of your project's asset health. It displays key metrics and provides quick access to common actions.
Dashboard Overview¶
The dashboard is organized into four main cards plus action buttons:
┌─────────────────────────────┬─────────────────────────────┐
│ PROJECT HEALTH │ UNUSED ASSETS │
│ A 90/100 │ 6 │
│ Excellent project hygiene │ Potential disk space │
│ │ [Delete Unused Assets] │
├─────────────────────────────┼─────────────────────────────┤
│ CIRCULAR DEPENDENCIES │ PROJECT STATS │
│ 0 ✓ │ 1,950 Total Assets │
│ No circular dependencies! │ 6,143 Connections │
│ │ 42 Folders | 3.1 Avg │
├─────────────────────────────┴─────────────────────────────┤
│ [Explore Dependency Graph] [Export Report] │
└───────────────────────────────────────────────────────────┘
Project Health Card¶
The Project Health card shows your overall project grade:
Grade Display¶
- Letter Grade: A, B, C, D, or F
- Numeric Score: 0-100 points
- Status Message: Brief description of your project state
Grade Thresholds¶
| Grade | Score Range | Color |
|---|---|---|
| A | 90-100 | Green |
| B | 80-89 | Yellow-Green |
| C | 70-79 | Yellow |
| D | 60-69 | Orange |
| F | 0-59 | Red |
Scoring Formula¶
The score starts at 100 and is reduced by:
- Orphan Penalty: Based on orphan-to-total-asset ratio
- Circular Penalty: Based on number of circular dependency chains
Info Icon
Hover over the ⓘ icon on the Project Health card for detailed scoring information including the current preset and thresholds.
Unused Assets Card¶
Displays the count of orphan (unreferenced) assets:
Key Information¶
- Count: Number of orphan assets found
- Potential Impact: Disk space that could be recovered
Actions¶
Click Delete Unused Assets to:
- Switch to the Graph Explorer view
- Open the Orphan panel
- Review and selectively delete assets
Ignored Assets
Assets you've marked as "ignored" are excluded from the orphan count. This is useful for intentionally standalone assets like splash screens or test content.
Circular Dependencies Card¶
Shows the count of circular dependency chains:
States¶
| Count | Display | Action |
|---|---|---|
| 0 | Green checkmark | No action needed |
| 1+ | Warning icon | Click to review |
Actions¶
Click the card when circulars are found to:
- Switch to Graph Explorer
- Open the Circular Dependencies panel
- See the dependency chains listed
Project Stats Card¶
Provides analytics about your project structure:
Metrics¶
| Metric | Description |
|---|---|
| Total Assets | All assets discovered in your project |
| Connections | Total dependency relationships between assets |
| Folders | Number of content folder clusters |
| Avg/Asset | Average connections per asset |
| Top Type | Most common asset type with count |
Insights¶
- High connection count may indicate tight coupling
- High avg/asset could suggest deep dependency trees
- Low folder count might mean poor organization
Action Buttons¶
Explore Dependency Graph¶
Opens the interactive graph visualization where you can:
- See all assets and their relationships
- Filter by type, folder, or search
- Expand/collapse folder clusters
- Access detailed asset actions
Export Report¶
Generates a report of your project analysis:
- JSON format: Machine-readable for automation
- CSV format: Spreadsheet-compatible
Reports include:
- All assets and their dependencies
- Orphan asset list
- Circular dependency chains
- Project statistics
Header Bar¶
The dashboard header includes:
| Button | Description |
|---|---|
| ↻ | Refresh/Rescan - Reanalyze the project |
| ⚙ | Settings - Open Project Settings for Asset Atlas |
| ? | Help - View documentation or restart onboarding |
Triple-Click Refresh
Triple-click the refresh button for a force refresh that clears cached state.
Upsell Banner¶
If Asset Optics or Asset Scaffolding are not installed, a banner appears at the bottom suggesting the ecosystem integration. Click × to dismiss.
If both are installed, the banner shows "Ecosystem Complete" with checkmarks.