---
title: "Your first part"
description: "Create a part from the dashboard in under a minute."
---

This walks through creating a single part — the smallest useful action in simple-plm.

## Steps

1. **Open the Parts list.** From the dashboard, click **Parts** in the left navigation. You'll see every part in the current branch.

   ![Parts list](/docs/screenshots/light/parts-list.png)

2. **Click "New part"** in the top right.

   ![Create part dialog](/docs/screenshots/light/create-part.png)

3. **Fill in the form.**
   - **Part number** — must match `^[A-Z0-9][A-Z0-9-]{2,49}$`. Examples: `R-10K-0603`, `PCB-MAIN-001`. The form validates inline; you can't submit an invalid PN.
   - **Description** — short human-readable label.
   - **Revision** — free-form string. Use `A` if your team has no scheme yet.
   - **Attributes** — optional key/value pairs.
4. **Click Create.** You land on the part detail page.

   ![Part detail](/docs/screenshots/light/part-detail.png)

## What just happened on disk

Behind the dashboard, a commit landed on the org's `main` branch:

```
+ plm-data/parts/PCB-MAIN-001/part.yaml
```

The file is roughly the YAML shown on the [Parts](/docs/concepts/parts/#on-disk) concept page. You can `git pull` the org's workspace repo locally and see it.

## Next

You probably want to attach a BOM next — see [Create a BOM](/docs/workflows/create-bom/).