BatteryBee

Troubleshooting

Common problems in the v2 designer usually come from stale auth, geometry constraints, case settings that remove cells, incomplete series assignments, or an export service that is not running.

Projects and auth

  • Unable to load projects: refresh and confirm you are signed in with the expected account.
  • Opening design never finishes: reload /designer and open the project again. If it repeats, duplicate or contact support.
  • Imported STL disappears after reload: confirm Firebase Storage is configured and the file is under the size limit.

Geometry and layout

  • Empty preview: confirm the outline has at least three points, depth is positive, and a cell spec is selected.
  • Fewer cells than expected: check wall thickness, clearance, keep-outs, cell spacing, spacer lips, layer gap, and depth.
  • Cannot delete an outline point: select it first; the outline must keep at least three points.
  • Cannot pan the outline: hold Space or Alt while dragging, or use the zoom HUD reset.

Case editor

  • Case not visible: enable Case and set wall thickness above zero.
  • Cannot add lids: use Printed case mode and open the Lids panel, then click Add and pick a face.
  • Cannot add panels: switch to Panelized case mode and open the Panels panel.
  • Cutout is not exported: open the cutout editor and Apply it; pending cutouts can be removed on cancel.
  • Cutout host looks wrong: panelized cutouts are lid/panel-hosted by default; bossed top/bottom cutouts are lid-hosted and side cutouts are case-hosted.
  • Mount is missing from export: confirm the mount status is Applied.

Series and busbars

  • Series tab is read-only: the series assignment is locked. Unlock from the toolbar or stats panel.
  • Cannot lock series: fix incomplete groups, invalid contiguity, and missing target counts in the stats panel.
  • Busbar prerequisites pending: finish series wiring until pack validity and busbar eligibility are positive.
  • Unexpected busbar side: check Flip busbars per layer and global bridge side settings.
  • Folds not included: enabled folds must be selected and have cells where required.

Exports

  • No scene to export: Geometry has not produced a viewer scene yet.
  • Select at least one item: enable Case, Lids/Panels, or Spacers before exporting the case zip.
  • Add at least one lid: printed-shell lid export is selected but no lids exist.
  • Case export fails locally: confirm the local export service is running and the web app points to it.
  • CadQuery/OCP import errors: reinstall export-service dependencies or use the Docker image.
  • Busbar DXF fails: confirm the local geometry dependencies are installed, or export SVG while debugging.
  • Export times out: reduce options such as slicing/breakdown, or increase export-service timeout and deployment resources.