📊 Summary

JCB automatically records and displays key build metrics — such as the most recent build time, total line count, field count, and compiled file size — so you can monitor project complexity and performance at a glance.

🧮 What It Tracks

Every time you compile a component in Joomla Component Builder (JCB), the system logs build-related metadata that gives you insight into:

• ⏱️ Last Build Timestamp — when the component was last successfully compiled
• 📦 File Size — size of the generated ZIP package
• 📄 Line Count — number of lines across compiled PHP/HTML/INI files
• 🧠 Field Count — total number of custom-defined fields across Admin Views
• 🧱 View Count — total Admin, Site, and Custom Admin Views used
• 📁 File/Folder Counts — number of files and folders output during build

This helps you estimate the size, complexity, and growth of your component over time.

🧭 Where It Appears

• 📘 At the bottom of the compiled README (if enabled)
• 🧩 Inside the Compiler’s summary output screen
• 📄 In the Component metadata page inside JCB
• 📤 Optional: exported via metadata.json file alongside builds

🔍 Use Cases

• Track how your component grows in complexity over time
• Compare different blueprint versions to see what's changed
• Monitor field bloat or layout overuse during iterative development
• Debug performance issues (large views or excessive custom logic)

📘 Pro Tip

Pair this feature with version-aware changelogs to gain insight into what triggered increases in line count or file generation between versions.

✅ Why It Matters

These metrics provide a lightweight yet powerful form of component observability. They help you answer questions like:

• “When did this component last compile?”
• “How big is the output ZIP?”
• “How many fields/views are we managing?”
• “Are we trending toward over-complexity?”

This fosters awareness and helps teams keep Joomla components lean, efficient, and well-structured.

📍 Conclusion

Component metrics aren’t just for curiosity — they are essential for healthy long-term project maintenance. With JCB’s automated tracking of build statistics, you always know where your component stands.