Skip to main content

Overview

The baseplate geometry module generates Gridfinity-compatible baseplates with precision socket profiles. Baseplates provide a stable mounting surface for bins with optional magnet and screw attachment points.
Implementation Status: This module is currently a placeholder stub. Full baseplate geometry generation is planned for a future release.

Import

Planned Features

The baseplate module will provide:

Socket Profile

Baseplates feature inverted socket geometry that bins nest into:
  • Socket depth: 4.75mm (matches bin base height)
  • Socket profile: 5-layer tapered walls for friction fit
  • Corner radius: 4.0mm (slightly larger than bin corners)
  • Per-cell sockets: Each grid cell has its own socket

Configuration Options

Magnet Integration

Baseplates can include magnet recesses that align with bin magnet holes:
  • Position: Four corners per cell, aligned with bin magnet holes
  • Dimensions: 6mm diameter × 2mm depth
  • Inset: 4.8mm from corner (matches bin magnet holes)
  • Polarity marking: Optional recesses for correct magnet orientation

Mounting Options

Screw Holes
  • Through-holes for M3 screws at cell corners
  • Optional countersink for flat-head screws
  • Aligns with bin screw holes for permanent mounting
Adhesive Mounting
  • Flat bottom surface for adhesive mounting
  • Optional anti-slip texture

Multi-Cell Baseplate

For baseplates spanning multiple cells:
  • Individual socket profiles per cell
  • Continuous base surface connecting all cells
  • Optional perimeter wall for alignment

Geometry Specifications

Vertical Profile (Per Socket)

The socket profile is the inverse of the bin base:

Dimensions

  • Total baseplate height: 6.4mm (GF.BASEPLATE_HEIGHT)
  • Socket depth: 4.75mm (GF.BASE_TOTAL_HEIGHT)
  • Remaining base thickness: 1.65mm (structural base below sockets)
  • Socket corner radius: 4.0mm (GF.BASE_CORNER_RADIUS)
  • Per-cell size: 42mm × 42mm (GF.CELL_SIZE)

Planned API

generateBaseplatePreview

Generate simplified baseplate for viewport rendering.
Simplified geometry:
  • Single-depth socket cavities (no layered profile)
  • Fast boolean operations
  • Suitable for real-time 3D viewport

generateBaseplateExport

Generate full-precision baseplate for 3D printing.
Full-precision geometry:
  • 5-layer tapered socket profiles per cell
  • Exact inverse of bin base geometry
  • Optimized for 3D printing

Implementation Notes

Socket Profile Generation

The socket profile will mirror the bin base Z-profile in reverse:

Magnet Recess Positioning

Magnet recesses align exactly with bin magnet holes:

Tolerance Considerations

  • Socket dimensions: Cell size minus tolerance (41.5mm per cell)
  • Corner radius: Slightly larger than bin corners for clearance
  • Magnet holes: Add 0.3mm clearance for press-fit magnets
  • Screw holes: 3.2mm clearance holes (vs 3.0mm screw diameter)

Usage Example (Planned)

From gridfinity/constants.ts:

Future Enhancements

  • Weighted baseplate: Increased base thickness for stability
  • Anti-slip texture: Bottom surface texturing
  • Mounting flanges: Side mounting holes for wall attachment
  • Cable routing: Channels between cells for cable management
  • Modular connection: Interlocking tabs for joining multiple baseplates

Current File Status

Source: src/gridfinity/baseplateGeometry.ts:1-4
The file currently exports an empty object as a placeholder. Implementation is planned for Phase 2 of development.