# MinimalPad

> Build, connect, configure, and troubleshoot your MinimalPad with clear step-by-step guides.

## Docs

- [Welcome to MinimalPad — Your Compact Wireless Macropad](https://docs.minimalmacropad.com/getting-started/welcome.md): MinimalPad is a 16-key wireless macropad with ZMK firmware. Configure every key in your browser without reflashing — no code required.
- [Quick Start: Connect and Configure Your MinimalPad](https://docs.minimalmacropad.com/getting-started/quick-start.md): Connect your MinimalPad to MinimalPad Studio over USB, inspect your current keymap, reassign a key, and save to flash — all in about five minutes.
- [Choose Your MinimalPad: DIY Kit or Fully Assembled](https://docs.minimalmacropad.com/getting-started/choose-your-minimalpad.md): Compare the MinimalPad DIY kit and fully assembled options, and choose between the NRF52840 clone and Nice!Nano V2 controller before you buy.
- [Before You Begin: What You Need to Set Up MinimalPad](https://docs.minimalmacropad.com/getting-started/before-you-begin.md): MinimalPad does not include a USB-C cable or battery. Check what you need before you start — including browser requirements for Studio.
- [MinimalPad Hardware: Keys, Encoder, and Connections](https://docs.minimalmacropad.com/getting-started/hardware-overview.md): Learn about MinimalPad's 16-key grid, rotary encoder, USB-C port, battery connector, RGB underglow, hot-swap sockets, and power behaviour.
- [Connect MinimalPad to Studio over USB — Quick Start](https://docs.minimalmacropad.com/connecting/connect-usb.md): Connect your MinimalPad to Studio via USB-C for the most reliable editing experience. Edit your keymap immediately — no unlock step needed.
- [Connect MinimalPad to Studio over Bluetooth Wireless](https://docs.minimalmacropad.com/connecting/connect-bluetooth.md): Configure MinimalPad wirelessly with Bluetooth. Requires a charged 3.7 V LiPo battery and Chrome or Edge. Use USB as a reliable fallback.
- [MinimalPad Studio Connection Status Indicator Guide](https://docs.minimalmacropad.com/connecting/connection-status.md): Learn what each Studio connection state means, from disconnected to fully ready, and what to do when the status indicator changes unexpectedly.
- [MinimalPad Studio: Browser-Based Key Configuration](https://docs.minimalmacropad.com/studio/overview.md): MinimalPad Studio lets you remap every key, manage layers, and assign RGB and Bluetooth actions — directly in your browser, no reflashing needed.
- [Inspect Your MinimalPad's Live Key Assignments in Studio](https://docs.minimalmacropad.com/studio/inspect-keymap.md): Learn how to read your MinimalPad's current key assignments in Studio — including per-layer views, key detail panels, and the encoder area.
- [How to Change a Key Assignment in MinimalPad Studio](https://docs.minimalmacropad.com/studio/change-a-key.md): Remap any key on any layer using MinimalPad Studio — pick a category, configure the action, assign it, and save. No reflashing required.
- [Save, Discard, and Disconnect in MinimalPad Studio](https://docs.minimalmacropad.com/studio/save-discard-disconnect.md): Understand the Assign → Save workflow in Studio: when changes hit the device, how to make them permanent, how to revert, and when it's safe to disconnect.
- [MinimalPad Studio Limitations and Firmware-Only Changes](https://docs.minimalmacropad.com/studio/limitations.md): Studio handles most configuration tasks, but encoder rotation, macro sequences, and some advanced behaviors require editing firmware and reflashing.
- [Assign a Single Keypress to Your MinimalPad in Studio](https://docs.minimalmacropad.com/studio/single-key.md): Assign any individual key — letters, numbers, function keys, navigation keys, or symbols — to a MinimalPad key using MinimalPad Studio.
- [Create Keyboard Shortcuts on MinimalPad with Studio](https://docs.minimalmacropad.com/studio/shortcuts.md): Assign multi-key combinations like Cmd+C, Ctrl+Z, or Ctrl+Shift+T to a single key press on your MinimalPad using MinimalPad Studio.
- [Assign Media and Application Controls to MinimalPad Keys](https://docs.minimalmacropad.com/studio/media-controls.md): Assign playback, volume, display brightness, and application controls to any MinimalPad key using the Media & Apps category in MinimalPad Studio.
- [Use Layers to Multiply Your MinimalPad Key Assignments](https://docs.minimalmacropad.com/studio/layers.md): Use layers in MinimalPad Studio to give your 16 keys different actions per context — like Shift on a standard keyboard, but for your entire layout.
- [Assign Bluetooth Profile Controls to MinimalPad Keys](https://docs.minimalmacropad.com/studio/bluetooth-actions.md): Assign Bluetooth profile switching, connection management, and USB/BT output toggling to MinimalPad keys using MinimalPad Studio's Device Controls.
- [Assign RGB Lighting Control Actions to MinimalPad Keys](https://docs.minimalmacropad.com/studio/rgb-actions.md): Assign RGB underglow controls — toggle, brightness, hue, effects, and more — to MinimalPad keys so you can adjust lighting with a single press.
- [Configure the MinimalPad Rotary Encoder in MinimalPad Studio](https://docs.minimalmacropad.com/studio/encoder.md): Learn how to configure the MinimalPad rotary encoder — assign any action to the encoder press in Studio, and understand how rotation is set in firmware.
- [MinimalPad Firmware and Studio: What Each One Does](https://docs.minimalmacropad.com/firmware/firmware-and-studio.md): Learn when to use MinimalPad Studio for everyday key changes and when you actually need to rebuild and reflash the firmware from source.
- [How to Install MinimalPad Studio Firmware on Your Device](https://docs.minimalmacropad.com/firmware/install-base-firmware.md): Download the minimalpad_with_studio firmware artifact from GitHub Actions and flash it to your MinimalPad using a USB-C cable and the UF2 bootloader.
- [Build Custom MinimalPad Firmware with GitHub Actions](https://docs.minimalmacropad.com/firmware/build-with-github-actions.md): Fork the MinimalPad firmware repo and use GitHub Actions to compile custom firmware — no local ZMK environment or command-line tools required.
- [Advanced: Customize MinimalPad Firmware Source Files](https://docs.minimalmacropad.com/firmware/advanced-customization.md): Edit the MinimalPad keymap source to change encoder rotation, create firmware macros, and modify compiled behavior beyond what Studio supports.
- [Recover Your MinimalPad with a Fresh Firmware Flash](https://docs.minimalmacropad.com/firmware/recover.md): Restore an unresponsive or misconfigured MinimalPad by entering bootloader mode and flashing fresh firmware — no special tools needed.
- [MinimalPad Not Found in Studio: Fix Connection Issues](https://docs.minimalmacropad.com/troubleshooting/studio-cannot-find.md): If MinimalPad Studio doesn't show your device in the connection dialog, follow these steps to diagnose and resolve the issue quickly.
- [Troubleshoot MinimalPad Bluetooth Connection Issues](https://docs.minimalmacropad.com/troubleshooting/bluetooth-problems.md): Resolve Bluetooth issues with MinimalPad Studio, including devices not appearing in the picker, dropped connections, and stale OS pairings.
- [MinimalPad Studio Changes Not Saved: How to Fix It](https://docs.minimalmacropad.com/troubleshooting/changes-not-saved.md): Learn why key assignment changes in MinimalPad Studio may not persist and how to make sure your configuration is written to the device.
- [Troubleshoot MinimalPad Firmware Flashing Problems](https://docs.minimalmacropad.com/troubleshooting/flashing-problems.md): Resolve common firmware flashing issues on MinimalPad, including bootloader drive not appearing and the device not responding after flashing.
- [MinimalPad FAQ: Setup, Wireless, and Studio Questions](https://docs.minimalmacropad.com/troubleshooting/faq.md): Answers to the most common questions about MinimalPad compatibility, wireless setup, accessories, switch swapping, and Studio configuration.