Skip to main content

Build Summary Report

fast-access audit trail for every package generated

What It Means

After each successful compilation, Joomla Component Builder (JCB) generates a detailed Build Summary Report. This summary gives you a clear, structured overview of what was built, how it was built, and key metadata that helps you track and validate your component output. Whether you're developing solo or collaborating across teams, the Build Summary Report is your fast-access audit trail for every package generated.

What Is the Build Summary Report?

The Build Summary Report is a human-readable log and metrics overview that is generated at the end of every compile. It provides you with a structured breakdown of what was included in the build and how the compiler executed the process.

This includes:

  • Component Name, Version, and Build UUID
  • Total Entities Processed (Views, Fields, Layouts, Templates, etc.)
  • Language String Totals
  • Total Line Count of Output Code
  • Compilation Time (seconds)
  • Compiler Memory Usage
  • Dynamic GETs used
  • Packaging Details (ZIP name, size, signing, update server URLs)
  • Export Targets (if pushed to remote or repo)

Key Benefits

  • โœ… Transparency: Quickly confirm what was compiled, from which blueprint, and which entities were involved.
  • โœ… QA-Ready: Great for reviewing build metadata before packaging for distribution or release.
  • โœ… Repeatability: Each report includes a unique Build UUID so you can trace back to a specific compile even across large versioned projects.
  • โœ… Debugging: Detect inconsistencies (e.g., missing fields or templates) by scanning totals and inclusion logs.
  • โœ… Audit Logs: Serve as an immutable history of what was shipped, when, and from which version of your blueprint.

Whatโ€™s Included?

  • ๐Ÿ†” Component Name & UUID: See the precise version and fingerprint of your build.
  • ๐Ÿ“ฆ Output Summary:
    • # of Admin Views
    • # of Site Views
    • # of Custom Admin Views
    • # of Fields, Snippets, Templates
    • Total PHP/HTML lines generated
    • Language string totals
  • ๐Ÿง  Performance Stats:
    • Time to compile
    • Memory usage
    • ZIP archive size (if packaged)
    • Any skipped items or warnings
  • ๐Ÿ“œ Extra Info (if enabled):
    • Insert/Replace activity count
    • Detected overrides
    • Warnings or compiler notices

How to Access It

  • Available immediately after compiling via the GUI
  • Stored under Compiler History in JCB
  • Optionally downloadable or exportable in plain text or JSON

Conclusion

The Build Summary Report in JCB transforms every compilation into a traceable, transparent event. Whether you need confidence before releasing a version, details for debugging, or proof for audits โ€” the summary ensures nothing gets overlooked. Itโ€™s a key piece of your build lifecycle that turns automation into accountability.