Here is a wiring diagram showing how to connect a Mechaduino to a step/dir interface:

And here is a photo showing how we mount the encoder magnet and PCB:

We also recently pushed a bunch of improvements to the firmware on github... more documentation and examples coming soon!