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!

Workspace Overview

Geppetto Workspace

The Geppetto workspace contains all the tools to create a board

Basic Functions

Drag and Drop

Find modules from the righthand library. Modules are functional blocks that offer a specific feature, such as power, sensors, connectors, and more. To add a module, simply drag and drop its graphic onto your board.

Module Library


Drag modules with your mouse to position as desired. For more precise placement, you can nudge the module with your keyboard's arrow keys. You should keep modules within the board boundary, and in their own space (ie. not overlapping with another module).


To connect a module, hover over it and and click the requirement flags that appear. Flags allow you to establish dependencies, including power requirements, between specific modules.

Steps to Connect Modules

Color-coded requirement flags will display when you hover over a module. The flag color will indicate what needs to be done.

Requirement flags
A yellow flag and a red flag

Connect a red requirement flag

A red flag means that its dependency needs to be fulfilled by a new module from the library. Clicking this flag will make the module library automatically display matching options. Any of these options will fulfill the requirement.

When you add a valid module to your board, the red flag should detect it and turn yellow. You can now connect those two modules via their flags.

Connect a yellow requirement flag

A yellow flag means that another module on your board can fulfill its requirement.

1. Clicking the yellow (5.0V) flag causes a new flag to appear by the valid module.

2. Now, clicking that new flag establishes the 5.0V connection.

A connection is complete when the flag turns green. You can check where the module is connected by clicking this flag.

Disconnecting a module

Step 1. Click the green requirement flag
1. Click the requirement flag that you want to disconnect.

Step 2. Click the provider flag
2. Another green flag will appear on the provider. Click it to finish disconnecting.

The requirement flag should now become yellow, meaning it has disconnected.

Additional Controls


  • 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.


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

Color Indicators

Colors indicate the status of your board and modules. Find explanations of each status below.

Module Color

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 here.

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.


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: Create a product page for your design (requires a store account). You can choose to submit your design for manufacturing from here.


Connections mode

Allows the requirement flags to appear, which represent the connections that are necessary for a module on the board. You can only connect modules while this mode is toggled on.

Please note that Connections mode disables Dimensions mode, and vice versa.

Dimensions mode

Allows you to control your board size, set the distance between the edge of the board and a module, or the distance between two modules.

Steps to set dimensions

First ensure that Dimensions mode is on. Then, hover over the edge of the area to be measured until you see a dashed line.

Initial dimension dashed line
1. Click the edge to start a dimension.

Close the dimension
2. Click the opposing edge of the area to complete it.

Your dimension should now appear. Geppetto recognizes measurements in increments of 0.5mm. You can input a value to adjust the distance, and right-click to lock the dimension. Lastly, you can also use this mode to view the static size of any module.

Module Info mode

Allows you to see module information and access the data sheets for components associated with the module. To view the information, click a module while this mode is toggled on.

Tabs: My Account, Designed in Gumstix, and Community

Geppetto Tabs

Besides the workspace, other tabs in the top bar offer extra functionalities:

My Account

You can sign in via your Google or Yahoo account, or use your e-mail address to create a Geppetto account. Once logged in, your saved designs will display here.

Also find 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.

Ordering Your Geppetto Board

Please check Geppetto Orders for more information.