| name | enclosure-designer |
| description | Guides design and generation of 3D-printable enclosures for Arduino/ESP32/RP2040 projects. Use when user needs a case, box, housing, or enclosure for their electronics project. Provides parametric design guidance, OpenSCAD templates, STL generation tips, and print settings. |
Enclosure Designer
Creates 3D-printable enclosures for electronics projects.
Resources
This skill includes bundled tools and templates:
- scripts/generate_enclosure.py - Parametric OpenSCAD generator with PCB database
- assets/basic-template.scad - Customizable OpenSCAD template
Quick Start
Generate for specific PCB:
uv run scripts/generate_enclosure.py --pcb "Arduino Uno" --output uno_case.scad
uv run scripts/generate_enclosure.py --pcb "ESP32 DevKit" --output esp32_case.scad
Custom dimensions:
uv run scripts/generate_enclosure.py --width 100 --depth 60 --height 30 --output custom.scad
Interactive mode:
uv run scripts/generate_enclosure.py --interactive
List supported PCBs:
uv run scripts/generate_enclosure.py --list
When to Use
- "I need a case for my project"
- "How do I make an enclosure?"
- "Design a box for my Arduino"
- User has working circuit, needs housing
- Preparing for deployment/presentation
Design Workflow
Step 1: Gather Measurements
Ask user for:
1. Main board dimensions (L × W × H in mm)
2. Component clearances (tallest component height)
3. Connectors/ports that need access (USB, power jack, etc.)
4. Mounting holes (positions, diameters)
5. Any displays, buttons, LEDs that need cutouts
6. Environment (indoor/outdoor, waterproof?)
Step 2: Design Parameters
Enclosure Type: [Box/Clamshell/Snap-fit/Screw-mount]
Material: [PLA/PETG/ABS]
Wall Thickness: [2-3mm typical]
Mounting Style: [Standoffs/Clips/Rails]
Ventilation: [None/Slots/Holes]
Access: [Top-remove/Front-panel/Side-openings]
Step 3: Generate Design
Choose approach:
- Parametric OpenSCAD - Full customization
- Pre-made generator - Quick results
- Manual Fusion360/TinkerCAD - Visual design
Parametric OpenSCAD Template
Basic Project Box
// === PARAMETRIC PROJECT BOX ===
// Customize these values for your project
// Internal dimensions (mm)
inner_length = 70; // X axis
inner_width = 50; // Y axis
inner_height = 30; // Z axis (internal depth)
// Wall and tolerances
wall = 2.5; // Wall thickness
lid_tolerance = 0.4; // Gap for lid fit
corner_radius = 3; // Rounded corners
// Mounting standoffs
standoff_height = 5; // PCB clearance from bottom
standoff_dia = 6; // Standoff outer diameter
screw_hole_dia = 2.5; // M2.5 screw hole
// PCB mounting hole positions (from corner)
// Measure from your board!
pcb_holes = [
[5, 5], // Bottom-left
[65, 5], // Bottom-right
[5, 45], // Top-left
[65, 45] // Top-right
];
// Lid attachment
lid_screw_dia = 3; // M3 screws
lid_screw_positions = [
[5, 5],
[inner_length-5, 5],
[5, inner_width-5],
[inner_length-5, inner_width-5]
];
// Cutouts (add as needed)
usb_cutout = true;
usb_x = 35; // Center position
usb_width = 12;
usb_height = 8;
// === MODULES ===
module rounded_box(l, w, h, r) {
hull() {
for (x = [r, l-r])
for (y = [r, w-r])
translate([x, y, 0])
cylinder(h=h, r=r, $fn=32);
}
}
module standoff(h, outer_d, inner_d) {
difference() {
cylinder(h=h, d=outer_d, $fn=24);
cylinder(h=h+1, d=inner_d, $fn=24);
}
}
module box_base() {
outer_l = inner_length + 2*wall;
outer_w = inner_width + 2*wall;
outer_h = inner_height + wall; // Bottom wall
difference() {
// Outer shell
rounded_box(outer_l, outer_w, outer_h, corner_radius);
// Inner cavity
translate([wall, wall, wall])
rounded_box(inner_length, inner_width, inner_height+1, corner_radius-wall);
// USB cutout
if (usb_cutout) {
translate([wall + usb_x - usb_width/2, -1, wall + standoff_height])
cube([usb_width, wall+2, usb_height]);
}
}
// Add standoffs
for (pos = pcb_holes) {
translate([wall + pos[0], wall + pos[1], wall])
standoff(standoff_height, standoff_dia, screw_hole_dia);
}
}
module box_lid() {
lid_wall = wall - lid_tolerance;
outer_l = inner_length + 2*wall;
outer_w = inner_width + 2*wall;
lip_h = 5; // How deep lid inserts
// Lid top
rounded_box(outer_l, outer_w, wall, corner_radius);
// Lid lip (inserts into box)
translate([wall + lid_tolerance, wall + lid_tolerance, -lip_h])
difference() {
rounded_box(inner_length - 2*lid_tolerance,
inner_width - 2*lid_tolerance,
lip_h, corner_radius - wall);
}
}
// === RENDER ===
// Uncomment one at a time for printing:
box_base();
// translate([0, inner_width + 20, 0]) box_lid();
Adding Cutouts
// === CUTOUT LIBRARY ===
// Round hole (for buttons, LEDs)
module round_cutout(x, y, z, diameter, depth) {
translate([x, y, z])
rotate([90, 0, 0])
cylinder(h=depth, d=diameter, $fn=32);
}
// Rectangle (for displays, SD cards)
module rect_cutout(x, y, z, width, height, depth) {
translate([x - width/2, -0.1, z])
cube([width, depth + 0.2, height]);
}
// Slot (for ventilation, cables)
module slot_cutout(x, y, z, width, height, depth) {
translate([x, y, z])
hull() {
translate([0, 0, 0])
cylinder(h=depth, d=height, $fn=24);
translate([width-height, 0, 0])
cylinder(h=depth, d=height, $fn=24);
}
}
// OLED display cutout (128x64 module)
module oled_cutout() {
// Visible area
rect_cutout(inner_length/2, wall, inner_height - 15, 26, 14, wall+1);
// Mounting holes (if needed)
}
// Common connector dimensions
usb_micro = [8, 3]; // USB Micro
usb_c = [9, 3.5]; // USB-C
barrel_jack = [12, 12]; // 5.5mm DC jack (round)
sd_card = [15, 3]; // SD card slot
Online Generators (No CAD Needed)
Ultimate Box Maker (Thingiverse)
https://www.thingiverse.com/thing:1264391
Parameters:
- Enter internal dimensions
- Choose wall thickness
- Select lid type (snap/screw/slide)
- Add ventilation slots
- Download STL
Parametric Box by Heartman
https://www.thingiverse.com/thing:1355018
Good for:
- Simple project boxes
- Snap-fit lids
- Basic customization
FreeCAD + Parametric Enclosure
- Install FreeCAD
- Use Spreadsheet workbench for parameters
- Generate enclosure with formulas
- Export STL
Common Board Dimensions
Arduino Family
| Board | L × W × H (mm) | Mounting Holes |
|---|
| UNO R3 | 68.6 × 53.4 × 15 | 4 holes, 3.2mm |
| Nano | 45 × 18 × 8 | 2 holes, 1.5mm |
| Mega 2560 | 101.5 × 53.4 × 15 | 4 holes, 3.2mm |
| Pro Mini | 33 × 18 × 5 | None standard |
ESP32 Family
| Board | L × W × H (mm) | Mounting Holes |
|---|
| DevKit V1 (38pin) | 55 × 28 × 10 | None (use clips) |
| DevKit V1 (30pin) | 49 × 26 × 10 | None |
| NodeMCU-32S | 51 × 25 × 10 | 2 holes, 3mm |
| ESP32-CAM | 40 × 27 × 12 | 2 holes, 2mm |
Raspberry Pi Pico
| Board | L × W × H (mm) | Mounting Holes |
|---|
| Pico/Pico W | 51 × 21 × 4 | 4 holes, 2.1mm |
Common Modules
| Module | L × W × H (mm) | Notes |
|---|
| SSD1306 OLED 0.96" | 27 × 27 × 4 | 4 corners 2mm |
| BME280 | 15 × 12 × 3 | 2 holes 2mm |
| SD Card | 42 × 24 × 5 | 4 corners 2mm |
| TP4056 | 26 × 17 × 4 | None |
| 18650 holder | 77 × 21 × 19 | Varies |
Design Guidelines
Wall Thickness
Application Thickness
─────────────────────────────────────
Desktop/indoor 2.0 mm
Portable/handheld 2.5 mm
Outdoor 3.0 mm
Structural/load-bearing 4.0+ mm
Clearances
Component Add clearance
─────────────────────────────────────
PCB to wall 1-2 mm
USB/connector 0.5 mm extra per side
Moving parts 2-3 mm
Lid fit 0.3-0.5 mm gap
Mounting Strategies
PCB Standoffs:
[Standoff]──┐
│ │
[PCB] │ standoff_height
│ │
────────────┘
▲
box_floor
Edge Rails:
┌────────────┐
│ [PCB] │
│ ─────── │
│ / \ │ <-- Rails support PCB edges
└───┘ └────┘
Snap-in Clips:
┌──╲ ╱──┐
│ [PCB] │
│ ───────│
└─────────┘
▲
Flexible clips
Ventilation
When needed:
- MCU draws >100mA continuously
- Motor drivers
- Power regulators
- Any component getting warm
Vent patterns:
// Slot pattern (easy to print, good flow)
for (i = [0:5]) {
translate([10 + i*8, wall/2, 10])
slot_cutout(20, 3, wall+1);
}
// Honeycomb (looks cool, harder to print)
// Use pre-made pattern from Thingiverse
Print Settings
Material Selection
| Material | Pros | Cons | Best For |
|---|
| PLA | Easy to print, cheap | Weak to heat (>50°C) | Indoor projects |
| PETG | Heat resistant, strong | Stringing, harder | Outdoor, functional |
| ABS | Heat resistant, tough | Warps, fumes | Professional |
| ASA | UV resistant | Like ABS | Outdoor long-term |
Recommended Settings
PLA Enclosure:
Layer height: 0.2mm
Wall count: 3-4 (for 2-3mm wall)
Infill: 15-20%
Support: Usually not needed if designed right
Bed temp: 60°C
Nozzle temp: 200-210°C
PETG Enclosure:
Layer height: 0.2mm
Wall count: 3-4
Infill: 20-25%
Support: Often needed
Bed temp: 80°C
Nozzle temp: 230-245°C
Print slower than PLA
Orientation Tips
Print box BASE standing up (opening facing up)
- No supports needed
- Good surface finish inside
- Strong walls
Print LID flat (top surface down)
- Smooth exterior surface
- May need supports for cutouts
Waterproofing
IP Rating Guide
IP65 - Dust tight, water jets OK
IP67 - Dust tight, submersible briefly
IP68 - Dust tight, continuous submersion
Strategies
Rubber Gasket:
Add groove in lid for O-ring:
┌───╔═══════╗───┐
│ ║O-ring ║ │
│ ╚═══════╝ │
│ [box] │
└───────────────┘
Cable Glands:
- Use PG7/PG9 cable glands for wires
- Drill precise holes, thread in glands
- Seal with silicone if needed
Conformal Coating:
- Spray PCB with conformal coat
- Protects electronics inside box
Example: ESP32 Weather Station Enclosure
// ESP32 Weather Station Enclosure
// Components: ESP32 DevKit, BME280, SSD1306 OLED, 18650 battery
// Internal dimensions (measured from components + clearance)
inner_length = 80;
inner_width = 55;
inner_height = 50; // Room for battery under PCB
wall = 3; // Outdoor = thicker walls
// ESP32 on standoffs
esp_standoff_h = 25; // Above battery
esp_holes = [[5, 5], [5, 50], [52, 5], [52, 50]];
// OLED window position (top of enclosure)
oled_x = 40;
oled_y = 15;
oled_w = 28;
oled_h = 16;
// BME280 vent hole
bme_vent_x = 70;
bme_vent_y = 30;
bme_vent_dia = 8;
// USB access
usb_x = 30;
usb_y = inner_height - 15;
// Generate with above parameters...
Troubleshooting
| Problem | Cause | Solution |
|---|
| Lid too tight | Tolerance too small | Increase to 0.5mm |
| Lid too loose | Tolerance too large | Decrease, add clips |
| Screws strip | Holes too large | Use proper thread inserts |
| Parts don't fit | Measurement error | Remeasure, print test piece |
| Weak walls | Too thin, low infill | Increase wall count |
| Warping | ABS, big flat surfaces | Use brim, enclosure, PETG |
Resources
- OpenSCAD: https://openscad.org
- Thingiverse Customizer: Parametric designs
- Printables: More enclosure designs
- McMaster-Carr: Reference for hardware dimensions
