> For the complete documentation index, see [llms.txt](https://docs.protoboard.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.protoboard.xyz/start-here/quickstart-10-minutes.md).

# Quickstart: your first board in 10 minutes

Sign in, create a project and a board, connect an Arduino Nano to a BME280 sensor and read the DRC in about 10 minutes

## Goal

By the end of this page you'll have a project with one board in it, two real parts connected over I2C, and a live design rule check (DRC) that shows the connection is complete. This is the **Sensor test rig** board from the [line-following robot](https://docs.protoboard.xyz/tutorials/line-following-robot.md) demo project.

{% hint style="info" %}
**What you need:** a browser and a free account. No hardware, no install. Open [alpha.protoboard.ai](https://alpha.protoboard.ai) in another tab.
{% endhint %}

## Steps

{% stepper %}
{% step %}

### Sign in

1. Click the avatar at the top right, then **Sign In**.
2. Enter your email and click **Continue**, or click **Continue with Google**.
3. Enter your password. If the email is new, Protoboard shows the **Create account** form instead: fill in your name and a password, accept the privacy notice and click **Create Account**.

You land on **Home**, the dashboard.

<figure><picture><source srcset="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-5e88e49de7b0ea49cc4a2e025a0ba6b5cda60ee8%2Fsignin-dialog-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-72f1ee9bf9e9c5824d14bb1b2a097b80ccf2d66c%2Fsignin-dialog-light.png?alt=media" alt="The sign-in dialog with an email field, a Continue button and a Continue with Google button"></picture><figcaption><p>The sign-in dialog.</p></figcaption></figure>
{% endstep %}

{% step %}

### Create a project

A project is a folder of boards that share access. See [Projects, boards and parts](https://docs.protoboard.xyz/start-here/projects-boards-and-parts.md).

{% embed url="<https://cdn.protoboard.ai/docs/clip/quick-create-project?title=Create+a+project>" %}
Create a project
{% endembed %}

[Animated GIF](https://cdn.protoboard.ai/docs/clips/quick-create-project-light.gif) · Steps:

1. In the sidebar, next to **PROJECTS**, click **+** (New project).
2. Type a name, for example `Line-Following Robot`, and click **Create**.
3. Click the new project in the sidebar to open it.
   {% endstep %}

{% step %}

### Add a board to the project

{% embed url="<https://cdn.protoboard.ai/docs/clip/quick-add-board?title=Add+a+board+to+a+project>" %}
Add a board to a project
{% endembed %}

[Animated GIF](https://cdn.protoboard.ai/docs/clips/quick-add-board-light.gif) · Steps:

1. On the project page, click **New Board**.
2. In the **New board** dialog, type `Sensor test rig` as the board name. The dialog notes that the board is filed into this project.
3. Choose **Public** or **Private** if the dialog offers it, then click **Create board**.

The editor opens on an empty canvas.

{% hint style="info" %}
Use the project page's **New Board** button. The orange **New board** button in the sidebar creates a board that isn't in any project. You can move it into a project later.
{% endhint %}
{% endstep %}

{% step %}

### Add two parts

{% embed url="<https://cdn.protoboard.ai/docs/clip/parts-search-add?title=Add+a+part+from+the+Parts+Bin>" %}
Add a part from the Parts Bin
{% endembed %}

[Animated GIF](https://cdn.protoboard.ai/docs/clips/parts-search-add-light.gif) · Steps:

1. In the left rail, click **Parts Bin**. The panel is titled **Manage Parts**.
2. Type `arduino nano` in the search box and click **Add** on the Arduino Nano card. The part lands in the middle of the canvas.
3. Search for `BME280` and click **Add** on the BME280 card.
   {% endstep %}

{% step %}

### Connect them with a harness

{% embed url="<https://cdn.protoboard.ai/docs/clip/harness-connect?title=Connect+two+parts+with+a+harness>" %}
Connect two parts with a harness
{% endembed %}

[Animated GIF](https://cdn.protoboard.ai/docs/clips/harness-connect-light.gif) · Steps:

1. Hover over the edge of the BME280 until an orange handle appears.
2. Drag from the handle to the Arduino Nano and release. A grey harness labelled **UNKNOWN** appears and the Inspector opens for it.
3. Under **Interface selection**, open **Interface pair** and choose the I2C pair (for example `I2C Master <-> I2C Slave`).

Protoboard links SDA to SDA and SCL to SCL, assigns each signal to a pin on both parts, and turns the harness green with the protocol name.

**Keyboard alternative:** open the Inspector's object tree, select the BME280, activate **Create harness**, choose the Arduino Nano and activate **Create**. See [Accessibility](https://docs.protoboard.xyz/help/accessibility.md).
{% endstep %}

{% step %}

### Read the DRC

{% embed url="<https://cdn.protoboard.ai/docs/clip/drc-jump?title=Jump+to+a+DRC+issue>" %}
Jump to a DRC issue
{% endembed %}

[Animated GIF](https://cdn.protoboard.ai/docs/clips/drc-jump-light.gif) · Steps:

1. In the left rail, click **Board Review**.
2. Under **// DRC Issues**, any problems are grouped as **BLOCKED** or **PARTIAL**. A complete I2C harness shows no issue.
3. To practise, add a third part and connect it without choosing an interface pair. Expand the new issue and click the target icon to jump to it on the canvas.
   {% endstep %}

{% step %}

### Save

Signed-in boards save to the cloud automatically. The status next to the board name reads **Saving…**, then **Saved**. Press **Ctrl+S** (**⌘S** on a Mac) to save at once.
{% endstep %}
{% endstepper %}

## Result

You have a project, a board inside it and a validated I2C connection. Everything you did by hand, [ProtoBot](https://docs.protoboard.xyz/protobot/overview.md) can also do from a description, and an [external agent](https://docs.protoboard.xyz/agent-bridge/overview.md) can do over MCP.

## Common failures

<details>

<summary>The board shows NO PROJECT on My Boards</summary>

The board was created from the sidebar's **New board** button instead of the project page. On **My Boards**, open the board card's menu and pick the project under **Move to project**.

</details>

<details>

<summary>The New board dialog says I've used my private board slots</summary>

Free accounts can have 2 private boards. A private project makes its boards private, so create the board in a public project, make one of your private boards public, or upgrade. See [Plans, limits and Energy](https://docs.protoboard.xyz/start-here/plans-limits-and-energy.md).

</details>

<details>

<summary>No orange handle appears when I hover a part</summary>

Make sure the canvas is in **Select** mode, not Pan mode, and that you're editing the board. If the status pill says **Viewing**, open it and click **Start editing**.

</details>

<details>

<summary>The Interface pair list is empty</summary>

The two parts share no compatible interface. Check that you picked the parts you meant, or see [Fixing DRC failures](https://docs.protoboard.xyz/validate-and-build/fixing-drc-failures.md).

</details>

## Related pages

* [Projects, boards and parts](https://docs.protoboard.xyz/start-here/projects-boards-and-parts.md): what you just created
* [Build a line-following robot](https://docs.protoboard.xyz/tutorials/line-following-robot.md): the full demo project
* [Harnesses and function links](https://docs.protoboard.xyz/editor/harnesses-and-function-links.md): what the harness holds
* [How DRC works](https://docs.protoboard.xyz/validate-and-build/how-drc-works.md): every DRC state explained
