Skip to content

Repository files navigation

Gridfinity Studio

中文

A browser-only parametric generator for standard 42 mm Gridfinity risers and trays. It previews the final solid interactively and exports binary STL or a Bambu Studio project 3MF.

Try it online

Open Gridfinity Studio — no installation required. Model parameters, geometry generation, and exports all stay in your browser.

Features

  • Risers with printer-constrained X × Y grids, integer heights from 1U, and either a rounded stacking receiver or a fully smooth top.
  • Standard trays from 2U, with a rounded stackable rim or a flush nominal-height rim.
  • A 2D divider editor that merges and splits 42 mm minimum cells, plus quick whole-cell equal divisions.
  • Build-volume limits derived from 14 official Bambu 0.4 mm printer profiles.
  • Shadow-free MatCap preview with unrestricted orbit, pan, zoom, fit, and reset controls.
  • Binary STL and Bambu project 3MF export; parameter JSON export is intentionally not included.
  • Bambu projects include machine, 0.20 mm Standard process, Bambu PLA Basic filament, Gridfinity print overrides, and print orientation.
  • Automatic Chinese/English locale detection with a persistent manual selector.
  • Local processing: parameters, geometry, and exported models are not uploaded.

Preview and both export formats use the same boolean-unioned, watertight solid. The UI's “single solid” result is a connectivity check, not a visual overlap of separate shells.

Gridfinity conventions

  • 42 mm planar pitch.
  • 42N - 0.5 mm outer envelope for N cells.
  • 1U = 7 mm height unit.
  • Risers start at 1U; U is their effective lift after seating.
  • Trays start at 2U; U × 7 mm is nominal total height including the universal bottom profile.
  • The universal feet seat inside a baseplate or lower receiver, so they do not add effective stacked height.
  • The stackable rim extends about 3.55 mm above the nominal U plane and is not straight-wall storage depth.
  • Usable tray depth is U × 7 - 4.75 mm bottom profile - floor thickness.

See the 42 mm compatibility notes for the complete geometry and magnet-hole policy. This project omits magnet holes by default; magnets and screws are optional retention methods, not required positioning geometry.

Development

Node.js 22 or newer is recommended.

cd web
npm ci
npm run dev

Vite listens on http://127.0.0.1:4173/ by default. Run all Web checks with:

cd web
npm test
npm run build

Generated exports/, Web dist/, dependencies, and slicer scratch output are not versioned. The JavaScript/TypeScript Web generator is the only authoritative implementation.

Printing

  • Bambu project 3MF exports auto-flip smooth-top risers so the smooth face sits on the build plate.
  • Other risers and trays print with standard feet down. The Gridfinity bottom profile is designed for printable overhangs and normally needs no supports.
  • The included starting preset uses 3 walls, 15% gyroid, no supports, and no brim. Always review slicing for the actual material, size, and printer.
  • Print a 1×1 interface sample before a large batch and verify fit against the actual baseplate and drawer.

Browser geometry checks and community-model comparisons do not replace a physical fit test.

Licensing

Original project code and documentation are licensed under the MIT License.

The Bambu Studio preset snapshot at web/src/third_party/bambu-studio/profiles.json is excluded from the top-level MIT scope and separately marked AGPL-3.0-only. Its provenance, generator, and full license text are described beside the data and in THIRD_PARTY_NOTICES.md.

Gridfinity, Bambu Studio, Bambu Lab, and MakerWorld are names or trademarks of their respective owners. This is an independent community project and is not endorsed, sponsored, or affiliated with them.

About

Browser-based parametric Gridfinity riser and tray generator with interactive 3D preview and STL/Bambu 3MF export. Live: https://pandagao.github.io/gridfinity-studio/

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages