NeoGrid OpenSCAD Code Generation

Generates OpenSCAD code for 3D-printed connectors that join store-bought divider materials (MDF, plywood, acrylic) into custom drawer organization layouts.

Required Reading Before Generating Code

CRITICAL: NeoGrid is a HYBRID system:

3D-print: Connectors only (~50g filament per piece)
Buy/cut: Divider material (MDF, plywood, acrylic, uPVC) from hardware store

Official NeoGrid 2.0 implementation:

QuackWorks GitHub: https://github.com/AndyLevesque/QuackWorks/tree/main/NeoGrid
Local clone: /Users/aaron/workspace/infra/neat-little-package/.tmp/QuackWorks/NeoGrid/
Main files: Neogrid.scad (connectors), DrawerLabelsAndHandles.scad (labels)
License: CC BY-NC-SA 4.0

System references:

home-organization/neogrid-reference.md - System overview and material selection
Fetch QuackWorks repo for current parameter syntax

Core Understanding (Critical Architecture)

What Makes NeoGrid Different: Hybrid Economics

NOT a fully 3D-printed system. NeoGrid separates components by manufacturing efficiency:

3D-print the connectors:

Junctions (X, T, L, I, End pieces)
~50g filament per connector
Print time: 1-3 hours depending on connector type
Functional geometry (channels, retention, base mounting)

Buy the dividers:

8.5mm uPVC utility board (UK standard)
6.35mm (1/4") plywood (US standard)
3mm-9mm+ MDF, acrylic, foam board
Cost: ~$10-20 for entire drawer system vs hundreds in filament
Faster: Cut to length vs 50+ hours printing sheets

Why this works:

Connectors require precision geometry (print it)
Dividers are simple rectangles (buy it cheap)
Material cost: 90% savings vs fully printed
Assembly time: Cut dividers once, reuse connectors anywhere

Critical Parameter: Material Thickness

Most important parameter in entire system:

Material_Thickness = 8.5;  // MEASURE YOUR ACTUAL MATERIAL!

Why it's critical:

Even 0.2mm variation affects friction fit
Tolerance: ±0.15mm for proper grip
Too loose: Dividers wobble, layout collapses
Too tight: Dividers won't insert, connectors crack

Process:

Buy material from hardware store
Measure with calipers (NOT ruler)
If painted: Measure AFTER painting (adds thickness)
Print ONE test connector
Verify fit before batch printing
Adjust parameter by 0.1-0.2mm if needed

Common materials and actual measurements:

| Material | Nominal | Actual (measure!) | Setting | | ---------------- | ------- | ----------------- | ------- | | UK utility board | 8.5mm | 8.3-8.7mm | Measure | | US 1/4" plywood | 6.35mm | 6.0-6.5mm | Measure | | 6mm MDF | 6mm | 5.8-6.2mm | Measure | | 3mm acrylic | 3mm | 2.9-3.1mm | Measure |

Base System Integration

Connectors attach to drawer bottom via one of four base types:

Gridfinity (42mm grid):

Snaps onto Gridfinity baseplate
Allows repositioning without re-taping
Grid alignment ensures straight layouts
Use for drawers with existing Gridfinity setup

OpenGrid (25mm grid):

Vertical wall mounting option
Less common for drawer use
Two variants: Full (6.8mm) or Lite (3.4mm)
Optional directional snaps for vertical strength

Flat (30mm grid or custom):

No snap features, just flat base
Use adhesive/tape to secure
Flexible grid sizing
Simple, universal option

None (no base):

For non-drawer applications
Dividers rest on surface directly
Minimal filament usage

Connector Type Navigation

NeoGrid has 6 connector types (plus drawer label holders). Each has dedicated subpage:

| Connector | Use case | Read | | ------------------ | -------------------------------------------- | ------------------------------------- | | X Intersection | 4-way junctions (interior grid points) | ./connector-types/x-intersection.md | | T Intersection | 3-way junctions (edges, perpendicular joins) | ./connector-types/t-intersection.md | | L Intersection | Corner junctions (90° turns) | ./connector-types/l-intersection.md | | I Junction | Straight-through connections (in-line) | ./connector-types/straight-through.md | | Straight End | Terminators (open ends with buffer) | ./connector-types/straight-end.md | | Vertical Trim | Edge trim for drawer openings | ./connector-types/vertical-trim.md |

Drawer labels (bonus accessory):

Label holders that mount to drawer fronts
Hook mount (standard) or adhesive tape
Not part of divider system, but commonly paired
Read: ./drawer-labels.md

Material Selection Guide

Choose divider material based on budget, availability, and drawer use:

Detailed material comparison: ./hybrid-approach.md

Quick reference:

| Material | Thickness | Cost | Pros | Cons | | ------------------ | ------------- | -------- | --------------------------- | ----------------------------- | | uPVC utility board | 8.5mm | Low | Minimal paint, long lengths | UK-specific | | Plywood | 6mm, 8mm | Low | Strong, natural look | Needs finish | | MDF | 3mm, 6mm, 8mm | Very low | Cheap, smooth | Heavy, needs retention spikes | | Acrylic | 3mm, 6mm | Medium | Transparent, clean | Brittle, expensive | | Foam board | 5mm | Very low | Lightweight | Low strength |

Critical reminder: Measure actual material thickness before printing. Nominal ≠ actual.

Base Selection Guide

Choose base system based on drawer setup:

Detailed base options: ./base-options.md

Quick decision framework:

Do you have Gridfinity baseplate in drawer?
├─ Yes → Use Gridfinity base (42mm)
└─ No
   ├─ Want to add Gridfinity later? → Use Gridfinity base (future-proof)
   └─ No Gridfinity needed
      ├─ Want easy repositioning? → Use Flat base + adhesive (30mm)
      └─ Permanent install → Use None (minimal filament)

Multi-tile support (Gridfinity only):

grid_x = 2;  // 2 tiles wide (84mm)
grid_y = 3;  // 3 tiles deep (126mm)

Only X Intersection connectors support multi-tile bases currently.

Connector Selection Framework (Decision Layer)

When User Describes Drawer Layout

Use this decision tree to select connector types:

Ask these questions:

How many dividers meet at junction?
- Four (cross pattern) → X Intersection
- Three (T pattern) → T Intersection
- Two (corner) → L Intersection
- Two (straight line) → I Junction
- One (end of divider) → Straight End
Where is junction located?
- Interior grid point → X Intersection (most versatile)
- Edge with perpendicular divider → T Intersection
- Corner → L Intersection
- Drawer opening edge → Vertical Trim
What's the layout pattern?
- Regular grid → Mostly X Intersections + edges (T, L, End)
- Asymmetric compartments → Mix of all types as needed

Example layout analysis:

User: "3×3 grid in my drawer"

Analysis:
- Interior: 4 X Intersections (where grid lines cross)
- Edges: 8 T Intersections (where dividers meet drawer edge)
- Corners: 4 L Intersections (drawer corners)
- Total: 4 X + 8 T + 4 L = 16 connectors + 16 top pieces

Start with X Intersections: Most versatile, works for testing material fit.

Code Generation Best Practices

Parameter Organization

Always declare these parameters at top of file:

// CRITICAL: Material measurement
Material_Thickness = 8.5;      // MEASURE actual material with calipers!
Channel_Depth = 20;            // How deep material sits in connector
Wall_Thickness = 4;            // Connector wall thickness

// Base system selection
Selected_Base = "Gridfinity";  // Gridfinity | openGrid | Flat | None
grid_size = 42;                // Auto-set based on Selected_Base
grid_x = 1;                    // Tiles horizontally (Gridfinity only)
grid_y = 1;                    // Tiles vertically (Gridfinity only)

// Gridfinity-specific
Added_Base_Thickness = 1;      // Extra base height beyond profile

// OpenGrid-specific
openGrid_Full_or_Lite = "Lite";                     // Full | Lite
openGrid_Directional_Snap = false;                   // Vertical mounting
openGrid_Directional_Snap_Orientation = 1;           // 1-4 rotation

// Flat base
Flat_Base_Thickness = 1.4;     // Base thickness in mm

// Material retention
Retention_Spike = false;       // Add spikes for MDF (soft materials)
Spike_Scale = 1;               // Scale spike size

// Part selection
Select_Part = "X Intersection"; // See connector type options
Top_or_Bottom = "Both";        // Top | Bottom | Both

// Top chamfers
Top_Chamfers = true;           // Ease material insertion

Why this order: Critical material parameter first, base system second, optional features last.

Two-Piece System (Base + Top)

All connectors use two-piece design (except Vertical Trim):

// Bottom piece (has base attachment - Gridfinity/openGrid/Flat)
NeoGrid_X_Intersection_Base(
    Material_Thickness,
    Channel_Depth = Channel_Depth,
    Wall_Thickness = Wall_Thickness,
    grid_size = grid_size
);

// Top piece (caps the junction, no base)
NeoGrid_X_Intersection_Top(
    Material_Thickness,
    Channel_Depth = Channel_Depth,
    Wall_Thickness = Wall_Thickness,
    grid_size = grid_size
);

Why two pieces:

Base provides stability and positioning
Top locks dividers in place vertically
Allows swapping divider materials without reprinting bases
Separate prints = less support material

Assembly: Insert dividers into base channels → Place top piece over junction.

Material Thickness Workflow

When user says "I need connectors for X dividers":

Ask about material type and measurement:
- "What material? (MDF, plywood, acrylic, uPVC)"
- "Have you measured thickness with calipers?"
- "If painted, measure after painting"

Set Material_Thickness parameter:

Material_Thickness = 8.5;  // User's measured value

Recommend test print:
- "Print ONE X Intersection (base + top) to verify fit"
- "Divider should friction-fit securely without forcing"
- "Adjust parameter by ±0.1-0.2mm if needed"
Batch printing guidance:
- "After fit verified, print remaining connectors"
- "All connectors use same Material_Thickness"
- "Orientation: Parts print upright as displayed in QuackWorks"

Connector Module Integration

Read the QuackWorks source, don't reinvent:

// DON'T write connector geometry from scratch
// DO fetch current modules from QuackWorks repo

// Option 1: Direct include (if user has BOSL2)
include <BOSL2/std.scad>
include <BOSL2/rounding.scad>
include <path/to/Neogrid.scad>

NeoGrid_X_Intersection_Base(...);

// Option 2: Paste relevant module from QuackWorks
// (if user wants standalone file)
module NeoGrid_X_Intersection_Base(...) {
    // [copied from Neogrid.scad]
}

When to use each connector type: See connector-types/*.md for detailed geometry and use cases.

Common Pitfalls

Pitfall #1: Hardcoding Material Thickness Instead of Measuring

Problem: User says "I have 1/4 inch plywood", code uses Material_Thickness = 6.35, connectors don't fit.

Why it fails: Nominal thickness ≠ actual thickness. 1/4" plywood can be 6.0-6.5mm depending on manufacturer.

Better approach:

// DON'T assume nominal:
Material_Thickness = 6.35;  // "It's 1/4 inch"

// DO ask user to measure:
echo("CRITICAL: Measure actual material with calipers!");
echo("Even 0.2mm variation affects fit.");
Material_Thickness = 6.4;  // User's measured value

Pitfall #2: Skipping Test Print

Problem: User prints 20 connectors, discovers material doesn't fit, wastes filament.

Why it fails: Material variation, printer tolerance, measurement errors compound.

Better approach:

// Workflow guidance:
// 1. Print ONE X Intersection (base + top)
// 2. Test material fit
// 3. Adjust Material_Thickness ±0.1-0.2mm if needed
// 4. THEN batch print remaining connectors

Include in code comments: Remind user to test before batch printing.

Pitfall #3: Wrong Base System for User's Drawer

Problem: User has no Gridfinity baseplate, code generates Gridfinity base, connectors don't sit flat.

Why it fails: Didn't ask about existing drawer setup.

Better approach:

// Ask before generating:
// "Do you have Gridfinity baseplate in this drawer?"
// ├─ Yes → Selected_Base = "Gridfinity"
// └─ No → Selected_Base = "Flat"  // Use adhesive to secure

Pitfall #4: Forgetting Retention Spikes for Soft Materials

Problem: User has MDF dividers, connectors don't grip firmly, layout sags.

Why it fails: MDF is soft, benefits from retention spikes for friction.

Better approach:

// Check material type:
// "What divider material?"
// ├─ MDF → Retention_Spike = true;
// ├─ Plywood → Retention_Spike = false; (optional)
// └─ Acrylic → Retention_Spike = false; (never)

Pitfall #5: Multi-Tile Grid Without Gridfinity Base

Problem: User wants 2×3 connector grid, code sets grid_x=2, grid_y=3 with Selected_Base="Flat", parameters ignored.

Why it fails: Multi-tile support is Gridfinity-only (currently).

Better approach:

// Warn user:
if (grid_x > 1 || grid_y > 1) {
    echo("WARNING: Multi-tile (grid_x/grid_y) only supported with Gridfinity base");
    echo("For Flat/None base, use grid_x=1, grid_y=1");
}

Quality Checklist

Before delivering OpenSCAD code:

Required elements:

✓ Material_Thickness parameter clearly documented with measurement reminder
✓ Base system selected based on user's drawer setup
✓ Appropriate connector type(s) for layout described
✓ Top_or_Bottom set correctly (usually "Both")
✓ Retention_Spike evaluated based on material type
✓ Test print workflow mentioned in comments

Parameter validation:

✓ Material_Thickness: User measured actual material (not assumed nominal)
✓ Channel_Depth: Default 20mm (adequate for most drawers)
✓ Wall_Thickness: Default 4mm (adequate strength)
✓ grid_size: Auto-set based on Selected_Base (don't override unless custom)

Base system compliance:

✓ Selected_Base matches user's drawer setup
✓ If Gridfinity: grid_x/grid_y set for multi-tile (if needed)
✓ If openGrid: Full/Lite and directional snap configured
✓ If Flat: Flat_Base_Thickness set
✓ If None: User understands no base attachment

Code quality:

✓ Parameterized (uses Material_Thickness variable, not hardcoded values)
✓ Clear variable names
✓ Comments explain hybrid system approach
✓ Module calls use QuackWorks functions (don't reinvent)
✓ BOSL2 library referenced (required dependency)

User communication:

✓ Explained hybrid approach (print connectors, buy dividers)
✓ Material measurement workflow emphasized
✓ Test print recommended before batch
✓ Assembly instructions (base → dividers → top)
✓ Connector count calculated if layout specified

Assembly Workflow

Standard NeoGrid assembly process:

Design layout: Measure drawer, plan divider pattern
Measure material: Use calipers on actual divider material
Test print: ONE connector type (X Intersection recommended)
Verify fit: Material should friction-fit with slight resistance
Adjust if needed: ±0.1-0.2mm on Material_Thickness parameter
Cut dividers: Standard length 160mm (or 42mm × N - Material_Thickness)
Batch print: All connectors for layout
Assemble: Place bases → insert dividers → add tops
Install: Place in drawer (on baseplate or with adhesive)

Documentation References

NeoGrid Ecosystem:

NeoGrid 2.0: Hybrid drawer organization system
Created by Hands on Katie (Katie)
Licensed CC BY-NC-SA 4.0
This skill focuses on CODE GENERATION for connectors

Related skills:

home-organization/neogrid-reference.md - System overview, material selection, use cases
For system selection guidance, defer to that skill
This skill is only for "generate OpenSCAD code for NeoGrid connectors"

Official resources:

https://handsonkatie.com/neogrid-organise-your-big-items-with-this-free-and-open-source-system/
https://github.com/AndyLevesque/QuackWorks/tree/main/NeoGrid (authoritative code)
https://makerworld.com/en/models/1501061-neogrid-2-0-drawer-management-system

neogrid-openscad

NeoGrid OpenSCAD Code Generation

Required Reading Before Generating Code

Core Understanding (Critical Architecture)

What Makes NeoGrid Different: Hybrid Economics

Critical Parameter: Material Thickness

Base System Integration

Connector Type Navigation

Material Selection Guide

Detailed material comparison: ./hybrid-approach.md

Base Selection Guide

Detailed base options: ./base-options.md

Connector Selection Framework (Decision Layer)

When User Describes Drawer Layout

Code Generation Best Practices

Parameter Organization

Two-Piece System (Base + Top)

Material Thickness Workflow

Connector Module Integration

Common Pitfalls

Pitfall #1: Hardcoding Material Thickness Instead of Measuring

Pitfall #2: Skipping Test Print

Pitfall #3: Wrong Base System for User's Drawer

Pitfall #4: Forgetting Retention Spikes for Soft Materials

Pitfall #5: Multi-Tile Grid Without Gridfinity Base

Quality Checklist

Assembly Workflow

Documentation References