Skip to the content
2 layers74.5 × 100 mmRoyalpad, the printed circuit board in 3D

A custom 9-key macropad with an EC11 rotary encoder, 0.91-inch OLED display, and a custom KiCad PCB Built for Productivity.

Size
74.5 × 100 mm
Copper layers
2
Thickness
1.6 mm
Parts
30
Nets
23
Pads
92
Tracks, vias
135, 10
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
25 Oct 2026
Updated
29 Oct 2026

Overview

Royalpad is an open-source printed circuit board by Royal-Ibu, from the Royal-Ibu/Royalpad repository on GitHub, published under the MIT licence. It is a 2-layer board of 74.5 × 100 mm with 30 parts on 23 nets, routed with 135 tracks and 10 vias.

Its parts include 10 switches, 9 diodes, 1 IC and 1 connector. It belongs with the keyboards and input and lEDs and displays boards of this library.

README

README.md

Royalpad

A Custom 9-key Macropad with an EC11 Rotary Encoder, 0.91-inch OLED Display, and Custom KiCad PCB Built for Productivity. Royalpad was made as a submission for Hackpad V5 through the Stardance challenge.

Overview

Royalpad is a custom macropad that uses the Seeed Studio XIAO RP2040, QMK firmware, and brings nine mechanical MX switches, a clickable rotary encoder, and a small OLED display. Whether you're coding, CADding, trying to be productive, or doomscrolling optimally, this macropad is the tool for the job.

Renders

image Screenshot 2026-10-18 150451 image image Screenshot 2026-10-28 180010 image

Features

  • 3x3 Matrix Layout: A compact 3 × 3 grid of mechanical switches.
  • EC11 Rotary Encoder: Provides rotational input and a push-button click.
  • 0.91-inch OLED Display: A small screen for status or other information.
  • XIAO RP2040 Controller: A compact microcontroller board for the macropad.
  • Custom PCB: Designed in KiCad.
  • QMK Firmware: open-source firmware for maximum control
  • A cool case with triangle cutouts, because why not?

Bill of Materials (BOM)

ComponentQuantitySpecificationsSource / Notes
Seeed XIAO RP20401Unsoldered microcontroller boardSeeed Studio Documentation
1N4148 Diodes9Through-hole diodes, one per switchVishay Datasheet
MX-Style Switches9Mechanical keyboard switchesSwitch Datasheet
EC11E Rotary Encoder1Incremental rotary encoder with integrated push buttonEncoder Datasheet
0.91-inch OLED Display1Compact display moduleProvided by Hack Club
White Blank DSA Keycaps9Blank DSA-profile keycaps compatible with the selected switchesWhite, unlabelled keycaps - Provided by Hack Club
M3 × 16 mm Screws4Enclosure mounting fastenersProvided by Hack Club
Custom PCB1Custom-designed Royalpad circuit boardDesigned in KiCad
3D-Printed Top Case1Upper enclosure for the macropadDesigned in SolidWorks
3D-Printed Bottom Case1Lower enclosure housing the PCB and electronicsDesigned in SolidWorks
Rotary Encoder Knob1Knob compatible with the EC11E encoder shaftProvided by Hack Club

Firmware overview

RoyalPad uses QMK firmware to turn its nine-key macropad into five different shortcut layers. The active layer determines what each key and the rotary encoder do. The OLED displays the active mode and provides an on-screen menu for switching between modes. Main firmware features

  • Five modes: Main, Productivity, SOLIDWORKS, Coding and KiCad.
  • OLED display: Shows the active mode and the mode-selection menu.
  • Rotary encoder mode selector: Hold the encoder's push switch for five seconds to open the menu, rotate to move through the options, then press the encoder to select a mode.
  • Mode-specific encoder controls: The encoder changes behaviour depending on the selected mode.
  • Custom shortcuts: Key functions target common actions in everyday computer use, productivity applications, CAD, coding and PCB design. Mode-specific key functions The table below uses a left-to-right, top-to-bottom key order, from K1 to K9.

Layer 0: Main

KeyFunction
K1Copy
K2Paste
K3Undo
K4Cut
K5Save
K6Select All
K7Previous Track
K8Play/Pause
K9Next Track

Rotary Encoder: Turn to control system volume. Short press to mute or unmute.

Layer 1: Productivity

KeyFunction
K1Open Notion
K2Open ChatGPT
K3Open Gmail
K4Screenshot
K5Open Study Focus Pomodoro
K6Clipboard
K7Calendar
K8New Tab
K9Task View

Rotary Encoder: Page Up / Page Down navigation.

Layer 2: SOLIDWORKS

Note: The first eight commands use custom Ctrl + Alt + 1 through Ctrl + Alt + 8 shortcuts configured in SOLIDWORKS. Zoom to Fit uses the standard F shortcut.

KeyFunction
K1Start Sketch
K2Smart Dimension
K3Line
K4Corner Rectangle
K5Sketch Fillet
K6Trim Entities
K7Linear Sketch Pattern
K8Exit Sketch
K9Zoom to Fit

Rotary Encoder: Mouse-wheel viewport zoom.

Layer 3: Coding

KeyFunction
K1Open GitHub
K2Open Visual Studio Code
K3Open Terminal
K4Copy
K5Paste
K6Cut
K7Undo
K8Redo
K9Save

Rotary Encoder: Page Up / Page Down navigation.

Layer 4: KiCad

KeyFunction
K1Add Footprint
K2Route Tracks
K3Properties
K4Move
K5Rotate
K6Flip Footprint
K7Save
K8Refill Zones
K9Open 3D Viewer

Rotary Encoder: Switch between the B.Cu and F.Cu copper layers.

Additional Notes

  • Some SOLIDWORKS shortcuts require separate configuration within SOLIDWORKS.
  • Application-launch keys depend on the configured URLs or applications.
  • KiCad shortcuts may vary depending on the active editor and shortcut configuration.
  • Firmware updates require compiling and flashing a new .uf2 file.

A huge thank you to Stardance and Hack Club for providing such an awesome opportunity to design, build, and share a custom hardware project through the Hackpad Challenge!

Royalpad was my first time designing a custom PCB and building a custom hardware project. Throughout the process, I learned how to design and lay out a PCB using KiCad, including working with components such as MX-style switches, diodes, and a rotary encoder. I also used SOLIDWORKS to design a custom two-piece enclosure that fits the PCB and other components nicely. Beyond the hardware itself, this project gave me the opportunity to explore firmware and learn more about how software interacts with custom electronics. It was a great introduction to QMK firmware, as it was definitely a challenge to compile and code everything my Royalpad needed, especially for the various mode layers. I took inspiration from ReuTheCoder's Stratum in terms of how it utilizes different layers where each key performs a different function.

Most importantly, Royalpad gave me the confidence to take on a project that was completely new to me, work through unfamiliar tools and challenges, and develop skills that I can carry into future electronics, CAD, and engineering projects. I'm really grateful to Hack Club and Stardance for making this experience possible!

Parts

30
QtyValueFootprintReferences
9DDiode_THT:D_DO-35_SOD27_P7.62mm_HorizontalD1, D2, D3, D4, D5, D6, D7, D8, D9
9SW_PushButton_Switch_Keyboard:SW_Cherry_MX_1.00u_PCBSW1, SW2, SW3, SW4, SW5, SW6, SW7, SW8, SW9
5LOGOLOGOG***, G***, G***, G***, G***
1Conn_01x04_PinOLED Display:SSD1306-0.91-OLED-4pin-128x32J1
1MOUDLE-SEEEDUINO-XIAOLibrary:XIAO-Generic-Hybrid-14P-2.54-21X17.8MMU1
1RotaryEncoder_SwitchRotary_Encoder:RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mmSW10

The 26 most common of 30 parts.

Similar boards

  • 2 layers52.2 × 52.2 mmBase promicro, the printed circuit board in 3D

    Base promicro

    google/mozc-devices

    Circuit diagrams and firmware source code for Gboard DIY keyboards

    30 parts3kApache-2.0
  • 2 layers40.6 × 15.2 mmVr mmm, the printed circuit board in 3D

    Vr mmm

    rusefi/rusefi

    rusefi - GPL internal combustion engine control unit

    30 parts1.2k
  • 2 layers270 × 11 mmDaylight, the printed circuit board in 3D

    Daylight

    VoronDesign/Voron-Hardware

    Cool Hardware designed by the Voron Design group

    30 parts1.1kGPL-3.0
  • 2 layers65 × 30 mmRgb to hdmi, the printed circuit board in 3D

    Rgb to hdmi

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    30 parts1kGPL-3.0
  • 2 layers40.5 × 58 mmInitial v, the printed circuit board in 3D

    Initial v

    tenderlove/initial-v

    It's a BMW shifter converted to a Bluetooth Keyboard that you use with Vim

    30 parts1kApache-2.0
  • 2 layers34.3 × 41.8 mmMotionCubeViewAllForces, the printed circuit board in 3D

    MotionCubeViewAllForces

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    30 parts915
  • 2 layers57.4 × 62 mmPicoWS2812, the printed circuit board in 3D

    PicoWS2812

    ErichStyger/mcuoneclipse

    McuOnEclipse projects and examples

    30 parts765
  • 2 layers52.1 × 46.8 mmFIRE TEST PANEL, the printed circuit board in 3D

    FIRE TEST PANEL

    jrsteensen/OpenHornet

    OpenHornet 1:1 F/A-18C Simulator Repository

    30 parts431

Questions

How big is the Royalpad PCB?

It measures 74.5 × 100 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Royalpad use?

30 parts. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Royalpad KiCad files?

From the Royal-Ibu/Royalpad repository on GitHub, at the commit this page was made from: the board is PCB/libraries/Royalpad.kicad_pcb and its schematic PCB/libraries/Royalpad.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Royalpad design in my own project?

Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).