English | 中文
BOMBoard is an open source PCB component locator for manual SMT assembly and prototype soldering. It runs entirely in the local browser, requires no file upload, and helps you quickly find component positions on the rendered PCB after loading Gerber files plus BOM and coordinate data.
It is built for the practical workflow of looking at the physical board, searching a designator or BOM entry, and finding the corresponding location without repeatedly switching between drawings and spreadsheets. It loads a ZIP package or a local directory, validates the project files, renders the PCB from Gerber and drill data, and links the board view with BOM and coordinate data. Project data is kept in browser storage so a refresh can restore the current workspace until the project is closed manually.
- Local ZIP package or directory loading. No server upload is required.
- Gerber and Excellon drill rendering.
- BOM CSV/XLSX and coordinate CSV/XLSX parsing.
- Cross-probing between the board view and component list.
- BOM fuzzy search by designator, package, and component name.
- BOM sorting optimized for common SMD resistors, capacitors, and inductors.
- Browser-language based Chinese and English UI.
- Open source under GPL-3.0.
Found a parsing issue, rendering mismatch, footprint matching problem, or workflow issue? Please open an issue. 🐛
Pull requests are welcome. Improvements to Gerber compatibility, BOM/coordinate parsing, footprint matching, documentation, packaging, and UI details can be submitted as PRs. ✨
Open BOMBoard in the browser. The first screen prompts you to select a local ZIP package or directory. No upload is required; all files are loaded locally in the browser.
Select a ZIP package or directory that includes complete Gerber files, Excellon drill files, a coordinate CSV/XLSX file, and a BOM CSV/XLSX file. After validation, BOMBoard renders the PCB and lists the BOM components. The project name is shown at the top center of the viewer.
Use the Top and Bottom controls to switch board sides. When the search box is empty, the BOM list follows the current board side. Search by designator, package, or component name when you need to locate parts quickly. Search results include both top and bottom components, and results from the other side are marked with a side label.
Click the package/name area in the BOM to highlight the matching component group. This is useful for locating all components with the same identity on the current board side.
Click a single designator in the BOM, or click a component directly in the 2D viewer, to highlight only that component. The BOM list scrolls to the selected component automatically. If a search result is on the other board side, clicking it switches the viewer to that side and selects the component.
Click the selected BOM item again, or click empty space in the viewer, to clear the selection. Refreshing the browser restores the current workspace from local browser storage. Use the X button beside the side switch to close the project and clear the saved workspace.
- Node.js 22 or newer
- pnpm 10 or newer
pnpm install
pnpm dev:webpnpm build
pnpm typecheck
pnpm test