Skip to content

Quick Start

Get up and running with Asset Atlas in under 5 minutes. This guide walks you through your first project scan and introduces the core features.

Opening Asset Atlas

You can open Asset Atlas in three ways:

  1. Menu: Window > Asset Atlas
  2. Toolbar: Click the Asset Atlas button (if visible)
  3. Content Browser: Right-click any asset > View in Atlas

Your First Scan

Step 1: Scan Your Project

  1. Open Asset Atlas
  2. Click the Scan Project button (or Rescan if previously scanned)
  3. Wait for the analysis to complete (progress shown in button)

Scan Time

Scan time depends on project size. A typical project with 1,000 assets takes 5-15 seconds.

Step 2: Review Your Health Score

After scanning, you'll see the Project Health Dashboard with:

Card Description
Project Health Your overall grade (A-F) and score (0-100)
Unused Assets Count of orphan assets with no references
Circular Dependencies Count of circular dependency chains
Project Stats Total assets, connections, folders, and averages

Step 3: Understand Your Grade

The health grade is calculated based on:

  • Orphan ratio: Percentage of unused assets
  • Circular dependencies: Number of dependency cycles
Grade Score Range Meaning
A 90-100 Excellent project hygiene
B 80-89 Good, minor cleanup possible
C 70-79 Moderate issues to address
D 60-69 Significant cleanup needed
F 0-59 Critical issues requiring attention

Exploring the Dependency Graph

Click Explore Dependency Graph to open the interactive visualization:

  • Pan: Click and drag on empty space
  • Zoom: Mouse wheel
  • Select: Click on an asset node
  • Multi-select: Ctrl+click or drag selection box

Understanding Clusters

Assets are grouped into clusters by folder:

  • Collapsed clusters show as a single card with asset count
  • Click a cluster to expand and see individual assets
  • Click again to collapse

Node Colors

Color Meaning
Default Normal asset
Orange/Red Orphan (unused) asset
Yellow Part of circular dependency
Green Synced with Asset Optics (if integrated)

Right-Click Menu

Right-click any asset for quick actions:

  • Open in Content Browser
  • Open in Reference Viewer
  • Show Dependencies Only
  • Show References Only
  • Copy Path
  • Delete Asset (with confirmation)

Finding Issues

Orphan Assets

  1. Click Find Orphans or the Unused Assets card
  2. Review the orphan panel on the right
  3. Select assets and click Delete Selected or Ignore

Before Deleting

Review assets carefully. Some may be intentionally standalone (splash screens, test assets, etc.). Use Ignore to mark them as intentionally unused.

Circular Dependencies

  1. Click Find Circular or the Circular Dependencies card
  2. Review the circular panel showing dependency chains
  3. Click a chain to highlight it in the graph
  4. Resolve by refactoring dependencies or use Ignore if acceptable

Keyboard Shortcuts

Shortcut Action
Scroll Zoom in/out
Click + Drag Pan the view
Escape Clear selection
Delete Delete selected (with confirmation)

Next Steps