Build Metrics → Documentation → Offline Mode

Offline Mode

Track Unity builds locally without internet connection

Overview

🏠 Always Available

Build Metrics works offline by default. Every build is stored locally on your machine, even when you don't have an API key or internet connection.

  • ✓ Stores last 10 builds locally in Unity project
  • ✓ View metrics in Unity Editor without internet
  • ✓ Export to JSON for backup or analysis
  • ✓ Automatic sync when connection restored

Free Forever

Offline tracking is 100% free, no account required

Zero Setup

Works immediately after plugin installation

Privacy First

Your data stays on your machine

Viewing Build History

Open Build History Window

Tools → Build Metrics → Build History

What You'll See:

  • Last 10 builds - Most recent builds with full details
  • Build time chart - Visualize performance trends over time
  • Build size chart - Track how your app size changes
  • Platform breakdown - See metrics grouped by platform
  • Detailed metrics - Build time, size, Unity version, commit info

Build Details

Click any build to see comprehensive details:

Build Info

  • • Platform (Android, iOS, etc.)
  • • Build time (seconds)
  • • Build size (bytes)
  • • Unity version
  • • Development vs Release
  • • Timestamp

Git Info (if available)

  • • Commit SHA
  • • Commit message
  • • Branch name
  • • Dirty status

Export & Backup

Export Build History

Export your build history to JSON for backup, analysis, or sharing:

  1. Open Build History window: Tools → Build Metrics → Build History
  2. Click "Export to JSON" button
  3. Choose save location
  4. Use exported data with your own tools, spreadsheets, or analytics
Example JSON Export
{
  "builds": [
    {
      "platform": "Android",
      "buildTimeSeconds": 245,
      "outputSizeBytes": 52428800,
      "unityVersion": "2022.3.10f1",
      "timestamp": "2026-01-31T10:30:00Z",
      "developmentBuild": false,
      "gitCommitSha": "a1b2c3d",
      "gitBranch": "main"
    }
  ]
}

Storage Location

Build history is stored in your Unity project:

ProjectSettings/BuildMetricsHistory.json

This file is automatically created and updated. Add it to .gitignore if you don't want to commit build history to version control.

Transition to Cloud Sync

📤 Upgrade Anytime

When you're ready to sync builds to the cloud for team collaboration, regression detection, and unlimited history:

  1. Sign up at Build Metrics Dashboard
  2. Create a project and copy your API key
  3. In Unity: Tools → Build Metrics → Settings
  4. Paste your API key and enable "Auto Upload"
  5. Build your project - metrics sync to cloud automatically

What Changes:

  • ✓ Unlimited build history (not just last 10)
  • ✓ Team collaboration - share metrics across developers
  • ✓ Regression detection - get alerted when builds slow down or grow
  • ✓ CI/CD integration - track builds from GitHub Actions, GitLab CI, etc.
  • ✓ Trend analysis - view long-term performance trends
  • ✓ Webhooks - get Slack/Discord notifications

💡 Hybrid Mode

When you add an API key, Build Metrics continues storing builds locally AND uploads to cloud. You get both offline access and cloud features.

When to Use Offline Mode

Perfect For:

  • • Solo developers starting out
  • • Working without internet connection
  • • Privacy-sensitive projects
  • • Quick local performance checks
  • • Trying Build Metrics before upgrading

Consider Cloud For:

  • • Team collaboration
  • • CI/CD pipelines
  • • Long-term trend analysis
  • • Regression detection & alerts
  • • Unlimited build history

Troubleshooting

📭 Build History Window Empty

  • • Ensure you've completed at least one build after installing the plugin
  • • Check that Build Metrics plugin is properly installed
  • • Verify ProjectSettings/BuildMetricsHistory.json exists

🗂️ Old Builds Missing

Only the last 10 builds are stored locally. Older builds are automatically removed to save disk space.

✅ Solution

Export build history regularly, or upgrade to cloud sync for unlimited storage.

💾 Can't Export JSON

  • • Ensure you have write permissions in the target directory
  • • Try exporting to a different location
  • • Check Unity console for error messages

Next Steps

Webhooks & Alerts →

Get notified about build regressions (requires cloud sync)

Upgrade to Cloud →

Free tier: 100 builds/month with unlimited history