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
| Symptom | Likely Cause | Fix 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 Board | Likely Cause | How 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
.vibecncsaves run free in your browser at any size. Upgrading to Creator or Pro unlocks unlimited G-code export dimensions and expanded cloud storage.