Project Health Dashboard

Module: Core · Category: Release · Tool ID: ProjectHealthDashboard

The first tool you should run on any project. Aggregates lightweight asset-registry checks across six categories (Assets, Materials, Performance, Blueprints, Animation, Level) into one score and a categorized result list. Per-category color-coded scorecards make health-status obvious at a glance. Click any result to navigate; export the audit as a report.

Dashboard after Run Full Audit, six category cards with mixed scores visible, results list below, overall score callout at top.

One score for the whole project, and the findings behind it.

When to use it

• First run on any new or inherited project: gives the 30-second health overview
• Pre-milestone audit: confirming nothing critical regressed
• Pre-shipping sweep: high-level pass before the deeper Project Doctor Suite audit
• Onboarding new team members: they can see project state without running 100 individual tools

What it isn’t for

• Don’t expect deep per-tool insights. This is the summary. For detail, drill into specific tools per category.
• Don’t expect runtime / packaging audit. See Ship Lab for build / release.

Opening the tool

1. Open the EQLabs Hub — the Project Health Dashboard is the first card in the Release category.
2. Click the tool card.
3. Click Run Full Audit.

Interface tour

Section	What it does
Run Full Audit	Executes all six category checks
Export Report	Saves the audit as a report file
Copy Results	Plain-text dump
Overall Score	Aggregate 0–100 health score
Summary Label	Total checks run + result counts
Category cards (6)	Per-category color-coded score with error/warning counts
Results list	Per-issue row using FEQLabsResultItem — click to navigate

Project Health after an audit: one score for the whole project, the health of each category, and every finding listed underneath it.

Categories

Category	What it covers
Assets	Naming conventions, orphans, basic asset hygiene
Materials	Complexity, master/instance health
Performance	Texture sizes, draw call estimates, foliage density
Blueprints	Complexity, tick usage, deprecated nodes
Animation	AnimSequence / AnimBP basic checks
Level	Level lighting, world partition, replication setup

Score color coding

Score	Color	Meaning
90–100	Green	Healthy
70–89	Yellow	Some issues
50–69	Orange	Multiple issues
< 50	Red	Critical attention needed

Six category cards with mixed colored scores, error / warning counts per card.

Workflow

1. Click Run Full Audit.
2. Read the Overall Score + per-category cards.
3. Walk the Results list — single-click pings the asset/actor; double-click opens it.
4. For each Critical category, drill into the relevant module’s tools (e.g., low Materials score → Material Profiler, Material Layer Studio).
5. Re-run after fixes to confirm score recovery.
6. Optionally Export Report for milestone documentation.

Settings reference

No persisted settings beyond the standard tool framework.

Settings file: [Project]/Saved/EQLabs/Settings/ProjectHealthDashboard.json

Output

• In-panel score, categories and results list.
• Report export. Full audit as a file.
• Clipboard. Copy Results.
• No edits. Read-only audit (for fixes, drill into specific module tools).

Tips and gotchas

• Lightweight by design. Uses FAssetData and tag queries to avoid loading full assets. Runs fast even on large projects.
• Use as a signal, not the whole audit. The score is aggregate; for actionable detail, use the tool the category points to.
• Score doesn’t equal shippability. A 90+ score is great, but specific subsystem checks (Quest Readiness, Project Doctor) are still required before ship.

Full walkthrough

The full workflow, start to finish.

Related tools

• Project Doctor — flagship 5-tab pre-shipping audit (deep dive)
• Ship Lab — build / packaging / release pipeline
• Quest Readiness Scanner — XR-specific readiness