# Rack Maker docs

What Rack Maker is, where to start, the guided tours, and where each part of the app is explained.

Source: https://rack-maker.cbnsndwch.dev/docs

Rack Maker helps you plan a homelab rack before you build it. Pick a 10″ or 19″ rack, a DeskPi RackMate or wire shelving, place your devices in 3D, and check what fits. Rack Maker then gives you the parts list, a quote and STL files for the parts you print.

Everything it knows about hardware comes from a shared [catalog](https://rack-maker.cbnsndwch.dev/catalog) of racks, mounts and devices. If your device is missing, the device modeler turns your measurements into a 3D model with its ports. Your own AI agent can do the measuring for you.

## Three steps

1. **Start a project** on [Projects](https://rack-maker.cbnsndwch.dev/): from a template, like the RackMate TL1 or an 8-node DGX Spark cluster, or from an empty 10″ or 19″ rack. Creating one needs an account; opening one someone shares with you doesn't.
2. **Place parts.** Drag them from **Parts** onto the 3D view or the elevation, or click a part and then a place. Select anything to change it in the **Inspector**.
3. **Check and build.** The checks say what doesn't fit, **BOM & quote** prices what to buy, and **Printed parts** exports the STLs.

![The editor with a DeskPi RackMate TL1 project: the Parts palette on the left, the rack in 3D in the middle, and the summary, updates, inspector and front elevation on the right](https://rack-maker.cbnsndwch.dev/docs/shots/editor/overview-light.webp)

*A project in the editor: parts on the left, the rack in 3D, and its checks and details on the right.*

[Your first project](https://rack-maker.cbnsndwch.dev/docs/getting-started/first-project) walks through these steps in more detail.

## Sections

- [Getting started](https://rack-maker.cbnsndwch.dev/docs/getting-started): What Rack Maker is, accounts, your first project and the words it uses.
- [Editor guide](https://rack-maker.cbnsndwch.dev/docs/editor): Placing parts, the inspector, checks, the quote, exports and sharing.
- [Catalog](https://rack-maker.cbnsndwch.dev/docs/catalog): Browsing entries, revisions, namespaces, contributing, licences and reports.
- [Device modeler](https://rack-maker.cbnsndwch.dev/docs/modeler): Measure a device or design a part, and get a 3D model with its ports.
- [Using AI agents](https://rack-maker.cbnsndwch.dev/docs/agents): Connect your own AI agent over MCP to model devices for you.
- [API reference](https://rack-maker.cbnsndwch.dev/docs/api): The public HTTP endpoints.
- [FAQ](https://rack-maker.cbnsndwch.dev/docs/faq): Short answers about accounts, privacy, sharing, costs and more.

## Tours

Each tour takes about a minute and points at the real screen.

The editor tour runs inside a project: open a project and press **?** in its toolbar.

[Start the modeler tour](https://rack-maker.cbnsndwch.dev/catalog/model#tour)

[Start the catalog tour](https://rack-maker.cbnsndwch.dev/catalog#tour)

The welcome on the [Projects](https://rack-maker.cbnsndwch.dev/) page shows only on your first visit. To see it again:

## For AI agents

Rack Maker's device modeler can be driven by your own AI agent over MCP. [Using AI agents](https://rack-maker.cbnsndwch.dev/docs/agents) explains how to connect it and what it can do.

These docs are also available as plain Markdown: [/llms.txt](https://rack-maker.cbnsndwch.dev/llms.txt) lists every page, and [Docs for agents](https://rack-maker.cbnsndwch.dev/docs/agents/docs-for-agents) explains the other formats.
