> ## Documentation Index
> Fetch the complete documentation index at: https://docs.minimalmacropad.com/llms.txt
> Use this file to discover all available pages before exploring further.

# What You Need to Set Up Your MinimalPad

> MinimalPad does not include a USB-C cable or battery. Check what you need before you start, including the requirements for each configurator.

Before you plug in your MinimalPad for the first time, make sure you have everything the box doesn't include. A missing USB-C data cable is the single most common reason a first-time setup stalls.

## What's not in the box

### USB-C data cable

<Warning>
  A USB-C **data** cable is required and is **not included** in the box. A charge-only cable will not work for connecting to either configurator or for flashing firmware — it carries power but no data signal. If your MinimalPad isn't detected, a charge-only cable is the most common cause.
</Warning>

Most USB-C cables sold for phone charging are charge-only. Look for a cable explicitly labelled as a data cable, or use one you know works for data transfer with other devices (such as a cable that came with a phone, laptop, or USB hub).

### Battery (wireless operation only)

<Warning>
  A battery is required for wireless operation and is **not included**. MinimalPad can run on USB power alone for wired use, but you need a battery to use it over Bluetooth or to use it untethered.
</Warning>

You need a **3.7 V LiPo battery with a JST PH 2.0 mm connector**. It sits in an 80 × 50 mm cutout inside the case and can be up to 10 mm thick. The common sizes 605070, 103665, and 104567 all fit.

Capacity is up to you, as long as the battery fits. **Check the connector polarity before you connect it**: reversing it can damage the controller.

[Quick start](/getting-started/quick-start#step-3-add-a-battery-for-wireless-use) lists batteries that fit and shows how to connect one.

<Tip>
  Lithium batteries are difficult and expensive to ship internationally, which is why no MinimalPad ships with one. Buying one locally is usually quick.
</Tip>

## What you need to configure it

You configure the pad with one of two apps. Pick the one for your computer — [compare them](/configure/mac-or-browser).

### On a Mac

[MinimalPad Studio for Mac](/mac/overview) needs **macOS 14 (Sonoma) or later**, on Apple Silicon or Intel. Nothing else — no browser requirement, no drivers.

### On Windows, Linux, or macOS

[MinimalPad Studio for browser](/browser/overview) uses the Web Serial API (for USB) and the Web Bluetooth API (for wireless configuration). These are only available in Chromium-based browsers.

| Browser    | USB (Web Serial) | Bluetooth (Web Bluetooth) |
| ---------- | ---------------- | ------------------------- |
| **Chrome** | ✅ Supported      | ✅ Supported               |
| **Edge**   | ✅ Supported      | ✅ Supported               |
| Firefox    | ❌ Not supported  | ❌ Not supported           |
| Safari     | ❌ Not supported  | ❌ Not supported           |

Use Chrome or Edge. No extension or plugin is required — it runs entirely in the browser tab.

<Note>
  Web Bluetooth support can vary by operating system even within Chrome and Edge. If the Bluetooth option doesn't work reliably in the browser, connect over USB instead — USB is the more reliable path for configuration and works on all supported platforms.
</Note>

## Operating system

MinimalPad works on macOS, Windows, and Linux. No drivers are required. Once connected, it appears as a standard USB or Bluetooth keyboard on all three.

## Summary checklist

Before you begin:

* [ ] USB-C **data** cable (not included)
* [ ] macOS 14 or later for [Studio for Mac](/mac/overview), or Chrome/Edge for [Studio for browser](/browser/overview)
* [ ] A 3.7 V LiPo battery with a JST PH 2.0 connector, if using wirelessly (not included)
* [ ] A soldering iron and the [build guide](https://www.minimalmacropad.com/resources/how-to-build-a-minimalpad), if you bought the DIY kit