Skip to main content
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 or an unsupported browser are the most common reasons first-time setups stall — this page covers all of them so you’re ready to go.

​
What’s not in the box

​
USB-C data cable

A USB-C data cable is required and is not included in the box. A charge-only cable will not work for connecting to MinimalPad Studio or for flashing firmware — it carries power but no data signal. If Studio can’t detect your MinimalPad, a charge-only cable is the most common cause.
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)

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.
You need a 3.7V LiPo battery with a JST connector. This is the standard connector type used in most nRF52840-based wireless keyboards. Before purchasing a battery, check the MinimalPad product website for the required:
  • Voltage (3.7V LiPo)
  • Connector type and pitch (JST)
  • Connector polarity — verify polarity before connecting; reversing polarity can damage the controller
  • Recommended physical dimensions so the battery fits inside the case
Battery capacity is up to you. ZMK’s power consumption is very low, so even a small battery provides substantial runtime. A 300–500mAh battery balances size and runtime well for most users; smaller batteries (110–250mAh) minimise bulk, while larger ones (600mAh+) maximise time between charges.
Lithium batteries are regulated by shipping carriers, which is why they aren’t bundled with MinimalPad. Sourcing one locally is usually quick — search for “3.7V LiPo JST keyboard battery” and you’ll find plenty of compatible options.

​
Browser requirements

MinimalPad Studio uses the Web Serial API (for USB) and the Web Bluetooth API (for BLE configuration). These APIs are only available in Chromium-based browsers. Use Chrome or Edge. No browser extension or plugin is required — Studio runs entirely in the browser tab.
Web Bluetooth support can vary by operating system even within Chrome and Edge. If the Bluetooth connection option doesn’t work reliably in Studio, connect via USB instead — USB is the more reliable path for configuration and works on all supported platforms.

​
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 platforms.

​
Summary checklist

Before you begin:
  • USB-C data cable (not included)
  • Chrome or Edge browser (latest version recommended)
  • Battery with correct specs, if using wirelessly (not included — check minimalmacropad.com for specifications)
  • macOS, Windows, or Linux computer