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.
| Component | Technology | Core Responsibilities & Capabilities |
|---|---|---|
| Parametric Logic Engine |
Node.js Cloud Run |
|
| Nesting Optimization Engine |
C++ Cloud Run |
|
| Turnifure Studio (IDE) |
Vanilla JS (ES6+) Three.js r180 |
|
| Cloud Recipe Storage |
GCS IAM Token Auth |
|
| AR & 3D Runtime |
Three.js Hybrid Packed Binary |
|
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 rulesKey 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) whereb = 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
| Parameter | Standard Range | Function & Engineering Application |
|---|---|---|
nestingGap | 8.0 – 15.0 mm | Minimum part-to-part separation on the sheet. Prevents tool collisions and ensures adequate vacuum hold-down integrity during cutting. |
tightGap | 0.05 – 0.20 mm | Interference fit tolerance for structural friction joints, interlocking mortise-and-tenon connections, and hammer-tight assembly. |
looseGap | 0.30 – 0.60 mm | Clearance fit tolerance for sliding shelves, removable dividers, backer board grooves, and drawer runners. |
safeDiam | 6.0 – 8.0 mm | Nominal 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
| Variable | Group Code | Value | Description |
|---|---|---|---|
$ACADVER | 1 | AC1021 | AutoCAD 2007 format for universal CNC controller compatibility. |
$INSUNITS | 70 | 4 | Metric millimeter units. |
$DIMSCALE | 40 | 2.5 | Annotation and dimension scale factor. |
$EXTMIN / $EXTMAX | 10, 20 | Dynamic Coordinates | Defines 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:layernameattributes 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 Name | Color (Index) | Geometry Type | CAM Operation |
|---|---|---|---|
BOARD_NOMINAL | Grey (253) | Outer sheet boundary | Stock Definition / Boundary setup. |
CUT_OUT | Red (1) | Perimeter contours | Outside Profile (Depth = Material + Overcut). |
CUT_IN | Blue (5) | Through-mortises & slots | Inside Profile (Depth = Material + Overcut). |
POCKET_IN | Green (3) | Blind pockets & recesses | Pocket / 2D Area Clearance. |
ORGANIZATION | White (7) | Labels & alignment marks | Laser 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
- Measure actual material thickness using high-precision digital calipers.
- Enter measured thickness and actual bit diameter into the calibration recipe.
- Cut Model 24366 (generates progressive test slots with offsets from +0.00 mm to +0.30 mm).
- Test-fit the companion plug into each slot.
- Select the slot that delivers a firm, hammer-tight interference fit.
- Use that offset as the baseline
tightGapparameter for production builds.