---
title: "Getting Started"
description: "PocketMage overview, setup, and first steps."
---

# Getting Started

This is the shortest path from project overview to working firmware and app code.

## Your first path

1. Read [What is PocketMage](what-is-pocketmage.md).
2. Set up the build in [Build Environments](../development/build-environments.md).
3. Open the [PocketMageOS overview](../development/index.md).
4. Use [Making Apps](../guides/making-apps.md) when you are ready to write code.
5. Keep the [PocketMage Library](../reference/pocketmage-library.md) and [Command Manual](../command-manual/index.md) open while testing.

## Core pages

::: grids
::: grid
::: card "What is PocketMage" icon:info
Short device and firmware overview.

::: button "Open" ./what-is-pocketmage.md icon:arrow-right
:::
:::
::: grid
::: card "PocketMageOS" icon:cpu
Operating system and runtime overview.

::: button "Open" ../development/index.md icon:arrow-right
:::
:::
::: grid
::: card "Build Environments" icon:settings
PlatformIO setup and firmware builds.

::: button "Open" ../development/build-environments.md icon:arrow-right
:::
:::
::: grid
::: card "App Guides" icon:book-open
How to build native and OTA apps.

::: button "Open" ../guides/index.md icon:arrow-right
:::
:::
::: grid
::: card "Command Manual" icon:keyboard
Keys, shortcuts, and built-in commands.

::: button "Open" ../command-manual/index.md icon:arrow-right
:::
:::
::: grid
::: card "PocketMage Library" icon:box
The hardware wrapper and helper layer.

::: button "Open" ../reference/pocketmage-library.md icon:arrow-right
:::
:::
:::