Frequently Asked Questions

Everything you need to know about BOMblame and how it helps track your hardware BOM history.

Reading the History Page

How do I read the history page?

The History page is your Git history, filtered through a BOM lens. Every commit in your repository appears here — we just highlight the ones that actually changed your Bill of Materials.

Each entry shows the essential Git commit information: author, clickable commit SHA (links to your repository), timestamp, branch badge, and commit message.

  • BOM commits — Commits that affected your BOM get larger cards with one or more rows showing exactly what changed. These are the commits you'll spend most of your time reviewing.
  • Non-BOM commits — Commits that didn't change any BOM files appear as compact single-line entries. They're part of your history, but visually muted so they don't distract. When several happen in a row, we collapse them into a summary — click Show to expand.
What do I see on a BOM card?

Each BOM card shows one row per affected BOM type:

  • Schematic (SCH) — Components from your schematic design
  • PCB — Components placed on the board layout
  • Design State — Combined view showing which components are actually mounted

Colored dots give you a quick visual scan of what changed:

Added Removed Modified Mounted Not mounted

Card colors indicate special events:

  • Green (Project Started) — The first commit where this BOM appeared
  • Amber (Project Renamed) — You moved or renamed the project file
  • Red (Parse Error) — We couldn't read a BOM file
What do I see when I expand the details?

Click the chevron (⌄) to see component-level changes. The expanded table shows each affected component with:

  • Reference designator (R1, C5, U3, etc.)
  • Value and part number
  • What specifically changed

Each row has an icon indicating the type of change:

Added — New component
Removed — Component deleted
Modified — Value or properties changed
Mounted — Component placed on PCB
Not mounted — Component removed from PCB
How can I view a BOM or compare versions?

Each BOM row has action buttons:

View BOM — See the complete component list as it existed at that commit. Use this to see a snapshot of your BOM at any point in time.
View Diff — Open a side-by-side comparison with the previous version. Use this for the clearest picture of what changed between versions.
What does the component amount on the History view page mean?

The component amount displayed on the History view page has different meanings depending on the file type:

  • SCH (Schematic) — The number of unique components you need to purchase
  • PCB — The number of unique objects to be produced on the board
  • Board Features — The number of objects you don't need to buy, such as fiducials and test points

Still have questions?

We're here to help. Reach out to our team and we'll get back to you as soon as possible.