Mint Motive MotiveMesh
Support Log in Sign up
Open standard · Public domain (CC0)

Contributing to MotiveMesh

Make compatible parts, improve the generator, or propose a change to the standard.

Version 1.0 · Public domain (CC0 1.0)

MotiveMesh belongs to everyone who builds with it. There are three ways to contribute: make parts, improve the generator, and improve the standard.

Make compatible parts

  1. Read the specification and the design guidelines.
  2. Print the fit test tile and a pin to check your printer.
  3. Design in any CAD program, starting from the reference drawings, or generate a base in MotiveMorph and remix it.
  4. Check the part against the conformance list (specification §10).
  5. Share it on VERTEX with the filament, clearance and Aura, tagged #motivemesh. Everything shared on VERTEX is CC0.

You do not need permission, and you may sell your parts or prints of them.

Improve the generator

The generator is public/js/geometry/morph.js in this repository. It has no dependencies.

  • Every mesh must be watertight: run npm test.
  • Every part must print without supports in the orientation it is exported in.
  • New items get tests in test/morph.test.js.
  • If a change alters a dimension in the specification, update SPECIFICATION.md in the same change and regenerate the reference files with node scripts/motivemesh-reference.mjs.

Improve the standard

Propose changes in the open, on the VERTEX Forum (MotiveMesh and MotiveMorph board) or as an issue or pull request in this repository. A proposal should say:

  • what problem it solves;
  • what changes, with dimensions;
  • whether existing parts still fit (compatible) or not (breaking);
  • how it was tested: printers, filaments, clearance, and what failed before it worked.

Changes that keep existing parts fitting can go into a minor version. Changes that break fit need a major version and a clear reason.

Versions

The specification uses version numbers like software:

  • Major (2.0): existing parts may no longer fit.
  • Minor (1.1): new parts or options; everything that fitted still fits.
  • Patch (1.0.1): wording and corrections that do not change any part.

Draft means the dimensions are complete and the generator follows them, but they have not yet been confirmed by test prints on a range of printers. Version 1.0 leaves draft when the pin, key and Desk Pod fits have been confirmed on at least three different printer models, and the results are published on the forum.

Proposed for later versions

  • A detent in the twist-lock so it clicks when locked.
  • Load ratings for tiles, pins and common accessories, measured and published.
  • A drawer and cabinet format on the same 30 mm grid.
  • Desk Pods that stack.

Licence

To the extent possible under law, the contributors have waived all copyright and related or neighbouring rights to MotiveMesh, its specification, documents, reference files and generator, under CC0 1.0 Universal. By contributing, you agree to release your contribution the same way. See LICENSE at the root of this repository.