Pulse — Project Health Dashboard & Asset Auditor

Pulse scans your Unity project and gives you a letter grade — A through F — based on what it finds. Broken references, uncompressed textures, duplicate files, unused assets, bad platform settings. The stuff that causes build bloat and runtime bugs but is tedious to track down manually.

Hit Rescan, get your grade, and fix things directly from the dashboard. Every fixable issue has a button next to it. You can fix individually or batch-fix entire categories.

WHAT IT CHECKS

- Missing references in prefabs, scenes, and ScriptableObjects

- Oversized textures and audio (file size and dimensions)

- Uncompressed textures and PCM audio

- Unused assets not referenced by any scene, Resources folder, or Addressable group

- Duplicate files detected by content hash

- Platform settings (color space, scripting backend, compression, stripping level)

- Build size estimates per platform

- Script compile errors and warnings

AUTO-FIX

Every issue that can be fixed has a Fix button. Texture too big? Compresses it. Audio using PCM? Switches to Vorbis. Wrong scripting backend? Sets IL2CPP. Unused assets? Batch-delete sends them to your recycle bin — never a permanent delete. Everything registers with Undo so you can roll it back.

For duplicates, Pulse remaps GUID references automatically when you remove copies. You pick which file to keep, or let it auto-resolve by keeping the shallowest path.

ASSET TREEMAP

A visual map of your project's assets, sized by file size and color-coded by type (textures, audio, meshes, scripts, video). Click any block to select the asset. Filter by category or minimum size to focus on what matters.

PRE-BUILD VALIDATION

Set a minimum grade in Project Settings and Pulse checks before every build. You can have it warn you or outright block the build — configurable per project.

SCORE HISTORY

Each scan is recorded. The dashboard shows whether your score is trending up, down, or holding steady compared to the last scan. History is stored in ProjectSettings so it can be version-controlled.

CI / COMMAND LINE

Run Pulse headlessly in your build pipeline:

Unity -batchmode -executeMethod ItsBenProductions.Pulse.Editor.CI.CLI.RunHealthCheck -pulseMinGrade B -quit

Outputs JSON or Markdown. Returns exit code 1 if the grade is below your threshold.

HOW TO USE

1. Import the package

2. Open Window > Pulse > Dashboard

3. Click Rescan

4. See your grade

5. Click Fix on any issue, or Fix All for a whole category

6. Optionally set a pre-build grade gate in Edit > Project Settings > Pulse

Works out of the box. All thresholds are configurable if the defaults don't fit your project.