Technical Specifications

Last Updated: November 02, 2026

1. System Architecture & Execution Pipeline

Overview: Turnifure employs a decoupled cloud architecture designed for low-latency parametric CAD generation, real-time 2D/3D visualization, and automated CNC nesting. Heavy computational tasks are isolated in microservices, while client-side inspection runs on high-performance WebGL and WebAssembly engines.

ComponentTechnologyCore Responsibilities & Capabilities
Parametric Logic Engine Node.js
Cloud Run
  • Recipe Interpretation: Parses declarative JSON/YAML parametric recipes, resolves dependency graphs, and calculates dynamic dimensions.
  • Vector Generation: Solves 2D toolpaths, contour profiles, mortise/tenon joints, and Rafix hardware placements.
  • Hierarchical Assemblies: Compiles component trees into 3D translation/rotation matrices.
Nesting Optimization Engine C++
Cloud Run
  • High-Precision Computing: Uses integer coordinate scaling (COORD_SCALE = 1000.0 / 1 µm resolution) to eliminate floating-point drift.
  • Dynamic NFP Packing: Executes No-Fit-Polygon placement via Libnest2d with ClipperLib boolean operations.
  • Void Utilization: Places smaller parts within the internal cutouts and concave waste envelopes of larger parts.
Turnifure Studio (IDE) Vanilla JS (ES6+)
Three.js r180
  • TurnifureSingleEditor: Single-layer editor with collapsible gutters and 250-state transaction-based undo/redo engine.
  • Zero-Latency Tracking: Real-time 0ms SVG reticle crosshair overlay on active coordinate vertices.
  • Dual-Mode Visualizer: Un-nested 2D flat draft layout with baseline alignment and Three.js 3D assembly viewport.
Cloud Recipe Storage GCS
IAM Token Auth
  • Private Bucket: Dedicated tf-recipes-uswest1 storage with Uniform Bucket-Level Access.
  • Object Versioning: Historical snapshot capture, generation tracking, and one-click version restoration.
  • Sandboxing: Strict per-user partitioning under recipes/{user_id}/{recipe_id}.yaml.
AR & 3D Runtime Three.js
Hybrid Packed Binary
  • Hybrid Packed Binary: Zero-bloat binary geometry transmission using contiguous Float32Array buffers and client-side creased normals.
  • WebXR Core: Hit-test raycasting, surface shadow estimation, and CAD-to-World matrix conversion.
  • iOS Quick Look Bridge: On-demand client-side binary GLB synthesis for native Apple AR Quick Look.

2. Parametric Recipe Specification

Models are defined in a clean, declarative YAML/JSON format rather than rigid boundary-representation meshes, providing full parametric flexibility across different materials, board thicknesses, and CNC tooling setups.

Declarative Recipe Pipeline

[input_parameters]     # User-configurable inputs (width, height, board thickness, bit diameter)
       │
       ▼
[derived_parameters]   # Deterministic mathematical formulas computed from inputs
       │
       ▼
[shape_definitions]    # 2D Polygons, Fillet Radii (r), Bulge Arcs (b), and Edgeband flags (eb)
       │
       ▼
[part_definitions]     # Physical parts with layers, tool diameters, and pocket cutouts
       │
       ▼
[components]           # 3D Hierarchical Assembly Tree with XYZ positions & rotations
       │
       ▼
[nesting / clusters]   # Multi-part clusters, grain alignment, and sheet layout rules

Key Parametric Features

  • Recursive Tree: Components can contain child components. The system traverses this hierarchy recursively to harvest all fabrication parts.
  • Deterministic Math: Math expressions (e.g., specs.bThick + (specs.tightGap || 0.1)) are parsed safely without dynamic arbitrary code execution.
  • Conditional Inclusion: Components support conditional predicates to dynamically include or exclude parts based on overall dimensions.

Bulge Arc Orientation Standard

  • Arc Representation: Contours utilize AutoCAD bulge factors (b) where b = tan(included_angle / 4).
  • Convex vs. Concave: A positive bulge defines a counter-clockwise arc, while a negative bulge indicates clockwise curvature, ensuring exact toolpath trajectory matching in CNC controllers.

3. Nesting Engine & Joinery Tolerances

Nesting Core: Dynamic No-Fit-Polygon (NFP) placer with multi-part combinatorial optimization. Capable of nesting complex organic silhouettes, convex panels, and interlocking joinery.

Nesting Capabilities

  • Part-in-Part Packing: Smaller components (brackets, cleats, shelves) are automatically packed into the waste cutouts and concave voids of larger panels before consuming new raw stock.
  • Variable Sheet Dimensions: Supports standard full sheets (e.g., 1220×2440 mm, 1500×3000 mm) as well as custom offcuts and remnants.
  • Grain Constraint Rules: Parts can enforce grain locking (0°/180° rotation only for visible wood grain) or unrestricted rotation (90°/any angle for isotropic composites like MDF).

Joinery Fitting & Toolpath Tolerances

ParameterStandard RangeFunction & Engineering Application
nestingGap8.0 – 15.0 mmMinimum part-to-part separation on the sheet. Prevents tool collisions and ensures adequate vacuum hold-down integrity during cutting.
tightGap0.05 – 0.20 mmInterference fit tolerance for structural friction joints, interlocking mortise-and-tenon connections, and hammer-tight assembly.
looseGap0.30 – 0.60 mmClearance fit tolerance for sliding shelves, removable dividers, backer board grooves, and drawer runners.
safeDiam6.0 – 8.0 mmNominal CNC compression router bit diameter used to compute internal corner dogbone or T-bone clearances.

4. Output Specifications (CNC CAM & Vector Formats)

4.1 DXF Specification (CNC Manufacturing)

Format: AutoCAD 2007 (AC1021) | Encoding: ANSI_1252 | Units: Millimeters

Header Variables

VariableGroup CodeValueDescription
$ACADVER1AC1021AutoCAD 2007 format for universal CNC controller compatibility.
$INSUNITS704Metric millimeter units.
$DIMSCALE402.5Annotation and dimension scale factor.
$EXTMIN / $EXTMAX10, 20Dynamic CoordinatesDefines overall bounding box coordinates of the nested sheet.

Geometric Entities

  • LWPOLYLINE: 2D lightweight polylines. Arcs are encoded via Group Code 42 (Bulge) to preserve true mathematical radii without chordal segmentation.
  • CIRCLE: Center point (10, 20) and radius (40) for CNC boring operations.
  • MTEXT: Part labeling, orientation arrows, and material thickness indicators (newlines handled via \P).

4.2 SVG Specification (Web & Shaper Origin)

Standard: SVG 1.1 | Namespace: xmlns:lc="https://turnifure.com"

Path Encoding

  • Vector Precision: High-precision coordinates preserving exact millimeters.
  • Arc Translation: Bulge geometric arcs are converted into smooth cubic Bezier control paths for web SVG visualizers.

Shaper Origin Metadata

  • Toolpath Tagging: Employs lc:layername attributes conforming to Shaper Origin on-tool automatic cut recognition.
  • Color Hierarchy: Red for exterior profiles, blue for interior cutouts, green for pocket clearances.

5. Layering & CAM Standards

Naming Convention: [OPERATION]_[DIRECTION]_Ø[TOOL_DIA]mm_↓[DEPTH]mm

Depth Handling: 2D geometry is rendered at Z=0.0. Machining depth and tool specifications are embedded directly in the layer metadata for automated CAM import.

Layer NameColor (Index)Geometry TypeCAM Operation
BOARD_NOMINALGrey (253)Outer sheet boundaryStock Definition / Boundary setup.
CUT_OUTRed (1)Perimeter contoursOutside Profile (Depth = Material + Overcut).
CUT_INBlue (5)Through-mortises & slotsInside Profile (Depth = Material + Overcut).
POCKET_INGreen (3)Blind pockets & recessesPocket / 2D Area Clearance.
ORGANIZATIONWhite (7)Labels & alignment marksLaser Etch / Pen Plot / Ignore.

6. Visualization & WebXR AR Pipeline

Client-Side Topology Engine

  • Hybrid Packed Binary & Creased Normals: Edge worker compiles 2.5D stepped B-Rep buffers into packed Float32Array binary payloads with zero JSON float stringification bloat. Three.js client dynamically calculates smooth creased normals on the GPU (30° dihedral crease threshold).
  • Edgeband Ribbon Generation: Dynamic offset inflation computes standalone perimeter meshes with independent PBR edgeband materials.
  • Demand-Driven Execution: Three.js renders on-demand during camera movement or parameter updates, maintaining 0% idle GPU consumption.

Augmented Reality (AR) Pipeline

  • Android / WebXR: Native hit-test raycasting with real-time floor anchoring, CAD (mm, Z-up) to World (m, Y-up) matrix transformation, and spherical harmonic lighting.
  • iOS Quick Look: Dynamic client-side binary GLB synthesis via GLTFExporter, executed dynamically through Google <model-viewer> to trigger native Apple AR Quick Look without server transcoding.

7. Turnifure Studio Developer Environment

Turnifure Studio provides parametric furniture creators with a web-based IDE for real-time vector inspection, structural debugging, and cloud persistence.

Precision Inspection Tools

  • Real-Time Vertex Tracking: Placing the text cursor on any coordinate in the recipe renders a zero-latency (0ms) reticle crosshair in the 2D draft view.
  • Interactive Ghost Poly: Uncommitted live edits render as a high-visibility dashed ghost polygon (#shaper-ghost-poly) before committing to 3D.
  • 2D Un-Nested Draft View: Automatically aligns distinct parts along a clean horizontal baseline (GAP = 120mm) with symmetrical part deduplication.

Cloud Persistence & Versioning

  • GCS Object Versioning: Saves revisions to private Google Cloud Storage (tf-recipes-uswest1) with automatic timestamped generation tracking.
  • Version History UI: Side-drawer interface allowing creators to review, label, duplicate, or restore earlier recipe snapshots.
  • Turnifure AI Copilot: Integrated side-sheet assistant trained on Turnifure recipe architecture to assist with formulas and joint math.

8. Machine Tolerance Calibration Protocol

Reference Model: Model ID 24366 (Calibration Set)

Purpose: Calibrates the precise interference fit tolerance for specific machine, tooling, and sheet material combinations.

Procedure

  1. Measure actual material thickness using high-precision digital calipers.
  2. Enter measured thickness and actual bit diameter into the calibration recipe.
  3. Cut Model 24366 (generates progressive test slots with offsets from +0.00 mm to +0.30 mm).
  4. Test-fit the companion plug into each slot.
  5. Select the slot that delivers a firm, hammer-tight interference fit.
  6. Use that offset as the baseline tightGap parameter for production builds.

The catalog is growing

get notified of new designs ▼