Skip to content

toolsstudio/buildlens-docs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BuildLens

Unity Build Size Analysis Tool — v1.0.0

BuildLens is a Unity Editor extension that analyses player build reports, visualises asset sizes through an interactive treemap, traces full dependency chains, and tracks build size growth across history — entirely inside the Editor, with no runtime footprint.

Source code: BuildLens


What BuildLens Does

After a Unity player build completes, BuildLens reads the BuildReport and answers three questions the default output cannot:

1. Which assets are largest, and what category drives the size? The Overview treemap renders every packed asset as a proportionally sized rectangle, colour-coded by type. The ranked asset list sits alongside it.

2. Why is a specific asset in the build? The Dependency panel shows the complete forward chain (what an asset depends on) and reverse chain (what caused the asset to be included). Transitive traversal to arbitrary depth is supported.

3. Did this build get larger than the previous one? The History panel stores up to 50 snapshots. Select any two to compute a diff: added assets, removed assets, and size-changed assets with exact byte deltas.


Documentation

Getting Started

Installation Requirements, import steps, storage layout
Quick Start Run your first analysis in five minutes
Demo Mode Explore every feature without a real build

User Guide

Toolbar Analyze button states, export controls, status label
Overview Panel Treemap, filter bar, asset list
Dependency Panel Forward and reverse dependency chains
History Panel Snapshot management and cross-build diff
Logs Panel Analysis event stream and error surfacing
Export JSON and CSV format reference

Architecture

System Overview Layer model, data flow, component map
Domain Layer AssetNode, DependencyGraph, BuildSnapshot, ViewModel
Application Layer AnalysisCoordinator, engines, session management
Infrastructure Layer BuildReportAdapter, AssetDatabaseWalker, SnapshotStore, ExportPipeline
Presentation Layer BuildLensWindow, panels, style contracts

Reference

Snapshot Schema Internal .blsnapshot and export JSON v1.1 / CSV schemas
Asset Classification How Unity types map to BuildLens categories
Limitations Known constraints and free version scope
Keyboard Shortcuts All interactive controls

Contributing

Contributing Guide Architecture rules, code standards, PR process

Supported Unity Versions

Version Status
Unity 6 (6000.0 LTS) ✅ Tested
2022.3 LTS ✅ Supported
2021.3 LTS ✅ Supported
2020.3 LTS ⚠️ Compatible, not actively tested
2019.4 LTS ⚠️ Minimum — some API constraints apply
< 2019.4 ❌ Not supported

Supported Build Targets

All Unity build targets supported by BuildReport are compatible. Verified targets:

  • Standalone (Windows, macOS, Linux)
  • Android
  • iOS
  • WebGL

Support

Discord (Support) Support
Bug Reports Bug Report
Email Contact