Troubleshooting

Troubleshooting & Shop FAQ

Fast fixes for common CNC CAD/CAM issues: open vector warnings, fuzzy top edges, scorch marks, oversized pockets, stepped walls, and Z-depth mismatches.

Most CNC problems have a simple geometric or mechanical root cause. Use this quick diagnostic table when a toolpath refuses to calculate or a cut on the router does not look right.

Design & Toolpath Calculation Issues

SymptomLikely CauseFix in VibeCNC
Pocket or V-Carve ignores a shape The vector is open (tiny gap between endpoints) or has a self-intersection. Run Vector Doctor to spot red crosshairs, or select the pieces and press J (Join Open Vectors).
Script letters have weird bumps in V-Carve Cursive glyphs overlap each other. Select the text, click To Curves, then click Weld to fuse the overlapping loops.
Toolpath shows a refresh/stale icon You edited a vector, Document Variable, or upstream pocket after calculating. Press Ctrl+Alt+R (Recalc All) before saving G-code.
Machine stutters on curved logos Imported SVG/DXF consists of thousands of tiny straight line segments. Select the artwork and run Fit Curves (Circular Arcs or Beziers) to reduce node count.

Shop-Floor Cut Quality Diagnostics

Symptom on the BoardLikely CauseHow to Fix It
Fuzzy / splintered top edge in plywood Using an upcut spiral bit on veneer. Switch to a Downcut or Compression end mill.
Dark burn marks in hardwood Spindle RPM too high, feedrate too slow, dull bit, or straight Z-plunging. Lower RPM or increase feedrate to restore proper chip load; keep Smart Ramp Entry enabled.
Cut goes too deep or leaves an onion skin Stock thickness in Job Setup does not match real board, or Z-zero setting mismatch. Measure stock with calipers, confirm Material Surface vs Machine Bed matches your physical Z-probe.
Slots/pockets are slightly too tight for tenons Bit deflection, undersized bit diameter, or missing corner relief. Measure actual bit diameter, add a Dog-Bone/T-Bone Fillet, or add -0.005" allowance offset.
Visible ridges on flat pocket floors Spindle slightly out of tram, or wide stepover. Tram your router spindle, tighten stepover to 35% to 40%, and enable a 0.02" Last Pass Thickness.
Part shifts loose on the final pass Missing or too-thin holding tabs. Enable 3D Holding Tabs (at least 0.35" long x 0.12" thick) or use painter's tape + CA glue workholding.

G-Code Export & Account FAQ

  • Why does G-code export say my account needs email verification? Verified email is required for free Hobbyist G-code exports (up to 18" x 18" 2D and 12" x 12" 3D), cloud storage, and monthly model credits.
  • Can I still design and preview a 48" x 96" cabinet sheet on the free tier? Yes. All 2D/3D CAD drawing, nesting, toolpath calculation, 3D simulation, and local .vibecnc saves run free in your browser at any size. Upgrading to Creator or Pro unlocks unlimited G-code export dimensions and expanded cloud storage.