Geppetto How-To

Geppetto Header

Welcome to Geppetto's How-To Guide. Geppetto is Gumstix' design-to-order tool for creating custom expansion boards quickly and easily. A design can be completed in hours, and ready to ship in fifteen business days.

New to Geppetto? Get started below!

  1. The Geppetto Workspace
  2. Toolbar and Module Library
  3. My Account, Designed in Gumstix, and Community Tabs
  4. Building in Geppetto
  5. Color Indicators
  6. Modes
  7. How to Order

1. The Geppetto Workspace

Geppetto Workspace

The Geppetto interface layout

The workspace tab has all the tools needed to create a design. Create your design in the layout area by dragging and dropping modules and creating connections between them.

2. Toolbar and Module Library


Geppetto Toolbar

The toolbar offers the following functionalities, and more:
Home: Return to the Gumstix homepage
New: Start a new design
Open: Browse and open your saved designs
Save / Save As: Save your design into the My Account tab (requires an account)
Connections: A mode allowing you to view and create connections between modules
Dimensions: A mode allowing you to take measurements
*For more information about Connections and Dimensions, see Modes.
Refocus: If you lose sight of your board, re-center it here
3D Preview: View your board as a to-scale 3D model
Help: View a quick tip slideshow
Show Price: Get a cost estimate for your working design
Complete Design: Submit your design for manufacturing (requires an account)

Module Library

Module Library

At the right of the workspace is the module library. Modules are functional blocks that offer specific features for your design and are grouped into categories based on their functionality. To add a module, simply drag and drop.

3. My Account, Designed in Gumstix, and Community Tabs

Geppetto Tabs

My Account

You can login to Geppetto using your Google or Yahoo accounts. You can also create a Geppetto-only account using your email address. Once logged in, your saved designs will show up under the My Account tab.

The toolbar here also contains toggles to change your theme colour to blue or black.

Designed by Gumstix

The Designed by Gumstix tab shows various boards sold by Gumstix and other boards designed by Gumstix Engineers. You can clone these boards and modify them to your design specifications.


In the community tab, you can see designs shared by others in the Geppetto community. You can clone a board from here, or make a design based on another. Sharing designs is optional as part of the save process.

4. Building in Geppetto

Adding Modules

Click and drag the module graphic onto the board and position as desired.

Rotating Modules

  • Right click on the module and select “ROTATE”
  • Or double click on the module
  • Or click on the module and press R on your keyboard

The module will then rotate 90 degrees counter clockwise. Repeat until you achieve the desired rotation.

Deleting Modules

  • Right click on the module and select “DELETE”
  • Or click on the module and press Delete on your keyboard

5. Color Indicators

Module Colour

Red Module


A dependency or requirement is missing from the board.

Yellow Module


Some connections have not been met but can be satisfied by an existing module on the board.

Green Module


All dependencies have been met.

Module Outline

Red Outline


The module cannot be placed here. Placement can be invalid if it is off the board, or overlapping with another module.

Black Outline

Black / Gray

The module can be physically placed in current location.

Board Outline

Red Board Border


The board is incomplete. Either the module is not properly placed within the board, a dependency is missing from the board, or both.

Yellow Board Border


There are unresolved connections between the modules on the board.

Green Board Border


All connections and dependencies have been met. The board is ready to be submitted for verification.

6. Modes

Connections mode:

Allows you to see connections that are necessary for a module on the board. If any of your modules are red, simply hover over the module to bring up the red connection flag. Click on the flag and all the modules that satisfy the connection within Geppetto will be shown on the right.

Dimensions mode:

Allows you to set static dimensions on your board or the distance between the edge of the board and a module. Simply select opposite sides of the board or module to see the current dimension. You can manually set the length. Geppetto recognizes measurements in increments of 0.5mm. To lock your dimensions, right click on the dimension and select lock. You can use the dimensions mode to also get the dimension of any module.

Module Info mode:

Allows you to see module information and access the data sheets for the components associated with the module.

7. Ordering Your Geppetto Board

Please check Geppetto Orders for more information.

Gumstix Design to Specification

If you require additional help, please email