Geppetto How-To

Geppetto Header

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

New to Geppetto? Check out the information below!

The Geppetto Workspace
Toolbar and Module Library
My Account, Designed in Gumstix, and Community Tabs
Building in Geppetto
Color Indicators
How to Order

The Geppetto Workspace


The Geppetto interface layout. Click here to expand.

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. The white rectangle represents your board.

Toolbar and Module Library


Geppetto Toolbar

The toolbar offers the following functionalities, and more:
Home: Return to
New: Start a new design
Open: Open an existing design
Save / Save As: Save your design
Connections: This mode allows you to view and create connections between modules
Dimensions: This mode allows you to take measurements of your board and its modules
For more information about Connections and Dimensions, see Modes.
Refocus: If you lose sight of your board, you can re-center it with this option
3D Preview: View your board in as a to-scale 3D model
Show Price: Get a cost estimate for your existing design
Order: 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.

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. You can filter your designs using the criteria on the left. You can also edit your account information or change your theme color using the toolbar.

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 in order to modify them to your design specifications.


In the community tab, you can see designs that have been created by others in the Geppetto community and are shared publicly. You may choose a board to clone or make your own design based on another. Sharing designs is optional as part of the save process.

Building in Geppetto

Adding Modules

Add modules by hovering over a module until you see a green plus sign. Click and drag the module onto the board and position as desired.

Rotating Modules

You can rotate modules by the following methods:

  • Right click on the module and select “ROTATE”
  • Double click on the module
  • Select the module by clicking it, and press R on your keyboard

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

Deleting Modules

You can delete a module in two ways:

  • Right click on the module and select “DELETE”
  • Select the module by clicking it, and press Delete on your keyboard

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 physically placed in current location. Placement can be invalid if it is off the board, or overlapping with another module.

Black Outline


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.


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.

Ordering Your Geppetto Board »

Gumstix Design to Specification

If you require additional help, please email