PureCutCNC

PureCutCNC is a browser-based 2.5D CAD / CAM workspace for designing parts, defining machining operations, previewing toolpaths, and checking the result in 3D and simulation before export. The core focus is 2.5D, but the app also handles 3D surface machining of imported meshes (rough and finish passes).

The durable product scope, supported surfaces, terminology, and CNC safety contract are defined in PROJECT.md. Contributors and AI agents should start at INDEX.md and follow AGENTS.md.

It is aimed at the kind of work where you want one place to:

• draw or import geometry
• organize features into machinable shapes
• assign operations such as pockets, contours, carving, and V-carving
• inspect the toolpath strategy visually
• export the result when it looks right

What You Can Do

Sketch geometry

Create and edit geometry directly in the Sketch view:

• rectangles, circles, polygons, splines, and composite profiles
• text features with built-in vector fonts
• tabs and clamps
• backdrop images for tracing

The sketch workflow includes:

• grid snapping
• feature / point / line / midpoint / center snapping
• marquee selection
• move, copy, resize, rotate, and offset transforms
• direct sketch editing with point add / delete / move and corner fillets
• on-canvas measurements while drawing and editing

Import geometry

Import source geometry and continue working with it as native sketch features:

• SVG import
• DXF import

Imported geometry can then be transformed, assigned operations, and used like hand-drawn features.

Import 3D models

Import STL and OBJ meshes to drive 3D surface machining:

• STL import (binary and ASCII)
• OBJ import
• axis orientation swaps for parts authored in a different up-axis
• automatic silhouette extraction so the mesh appears as a sketch feature you can position, transform, and use as a region

Imported meshes participate in Surface Rough and Surface Finish operations and are visible in both the 3D preview and the simulation view.

Work with text

Text is handled as an editable feature rather than exploded letter geometry.

Current text support includes:

• single-line text
• skeleton and outline text styles
• built-in font selection
• shared operation and Z settings across the text feature
• transform support through a text frame

Define CAM operations

Operations are created from selected geometry and managed in the CAM panel.

Current operation set includes:

• Pocket Rough
• Pocket Finish
• Surface Rough — rough clearing of an imported 3D mesh
• Surface Finish — finish pass on an imported 3D mesh (parallel and waterline patterns)
• Edge Route (inside / outside)
• Follow Line
• V-Carve (offset and skeleton modes)
• Drilling (simple, peck, dwell, chip-breaking)

The toolpath system supports things such as:

• multiple operation targets
• tabs and clamps
• parallel and offset-style pocket / surface patterns
• tool selection and feeds
• operation visibility and selection
• toolpath debugging for selected operations where needed

Inspect the result before export

The app provides three main working views:

• Sketch
  • author geometry
  • inspect selected toolpaths in 2D
  • check snapping, ordering, and direction
• 3D View
  • preview model geometry and toolpaths in 3D
  • inspect entry / exit and path direction
• Simulation
  • replay toolpaths against stock
  • verify that pockets, tabs, islands, and carving behavior match expectations

Typical Workflow

1. Start a new project and define stock.
2. Draw geometry, import SVG / DXF, or place a backdrop image for tracing.
3. Organize and edit features until the sketch matches the intended part.
4. Add CAM operations from the selected geometry.
5. Tune tooling, stepdown, stepover, pattern, and operation parameters.
6. Check the result in Sketch, 3D View, and Simulation.
7. Export once the toolpaths look correct.

Current Focus

PureCutCNC is under active development. The core workflow is already usable, but the project is still evolving in areas such as:

• additional font support and text workflows
• deeper DXF coverage
• more toolpath optimization
• richer simulation tooling
• more advanced carving and finishing workflows

Build And Run

Requirements

• Node.js 20+ is recommended
• npm

Install dependencies

npm install

Run the development server

npm run dev

Vite will print a local URL, typically:

http://localhost:5173

Create a production build

npm run build

The build includes the active-document check, lint, icon generation, TypeScript, structural tests, and the Vite production build. Documentation-only changes can run npm run docs:check first for faster feedback.

Preview the production build locally

npm run preview

CNC Safety

Preview and simulation are verification aids, not guarantees that a job is safe to run. The operator is responsible for the machine, stock, workholding, tool, controller setup, feeds/speeds, and physical test procedure. See PROJECT.md for the engineering safety contract.