2 layers18.5 × 11.1 mm
Switch
byrantech/laptop
anyon_e, a highly integrated, high end, open source laptop. Attempt the impossible.
6 parts4.3kMIT
2 layers80 × 20 mm
Releaf
nikolak/releaf1Open source, €5 Nanoleaf Shapes compatible controller. WLED based, fully local.
- Size
- 80 × 20 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 6
- Nets
- 18
- Pads
- 29
- Tracks, vias
- 71, 4
- Pours
- 6
- Routed
- Yes
- KiCad
- KiCad 10.0 (file 20260206)
- Created
- 14 Oct 2026
- Updated
- 26 Oct 2026
Overview
Releaf is an open-source printed circuit board by nikolak, from the nikolak/releaf repository on GitHub, published under the MIT licence. It is a 2-layer board of 80 × 20 mm with 6 parts on 18 nets, routed with 71 tracks and 4 vias.
It is built around the ESP1010. Its parts include 2 ICs, 1 capacitor, 1 resistor, 1 connector and 1 switch. It belongs with the ESP32 and RISC-V boards of this library.
Main components
1README
README.mdMy Nanoleaf Shapes controller died, and I wasn't about to drop €40 just to turn on my perfectly good light panels. So I built Releaf: a cheap, fully local WLED controller based on the C3 SuperMini.
I kept the goals simple:
- Keep it cheap.
- Make it easy to build.
- Use common parts.
- Keep everything local.
- Avoid heavy custom firmware.
I went a step further and made an optional PCB that keeps the footprint small. Technically, you just need a C3 SuperMini (about 2 bucks), a resistor (cents), some wire (cents), and either a step-down converter to power the C3 SuperMini via the panel power, or just power it via USB-C if you don't mind the extra cable. The full build with the PCB and everything comes to about €7-€9 depending on where you source your hardware, shipping costs, etc.
 |  |
Downloads
No need to compile the firmware yourself—just grab the binaries from the latest releases:
| File | What it's for |
|---|---|
releaf-esp32c3-factory.bin | First installation over USB, including the bootloader and partition table |
releaf-esp32c3.bin | Updating an existing Releaf installation through WLED |
releaf-gerbers.zip | Ordering the optional PCB |
releaf-shell.3mf | 3D printing the shell (Bambu Studio project with both halves). The STEP files are in hardware/shell. |
The firmware instructions cover flashing the downloaded files. Changes between versions are in the changelog.
Getting started
You can wire this directly, use a breadboard, or make the controller board below. The firmware is the same for all three.
- Grab a release and follow the firmware instructions to flash the C3. You can also build from source.
- Swap the cables: disconnect the original Nanoleaf controller and connect the C3 using the wiring below. The panels still use their original power supply.
- Power on the C3 and connect to WLED-AP (password:
wled1234). Open 4.3.2.1 and enter your Wi-Fi details. - Open WLED at its network address. Releaf finds the panels and their layout on its own, so you can use WLED's effects and presets as usual.
Wiring
Connect the C3 to the panels like this:
| C3 connection | Panel connection |
|---|---|
| GPIO4 (TX) and GPIO5 (RX) | Both connect to DATA |
| 3.3 V through a 10 kΩ resistor | DATA (the pull-up resistor) |
| GND | GND |
WLED still needs a configured LED output, so GPIO10 is used as a dummy output. Leave it unconnected; the panels communicate through GPIO4 and GPIO5.
You can power the C3 through USB-C, or use a step down converter to get 5 V from the panel supply. Crucial: Do not connect the panel's 41–42 V supply directly to the C3. Double-check the pinout as the linkers swap the 41v and DATA positions.
Optional controller board
The PCB integrates the C3 and power management into one board. It draws power directly from the panels, converting it to 5V for the C3 so you don't need an extra USB cable. All five components are through-hole and can be soldered by hand:
- ESP32-C3 SuperMini
- Pololu D45V5F5 converter
- ESP1010 switch
- 10 kΩ resistor
- 33 µF / 100 V capacitor
The Gerber files are ready for production. The board is 80 × 20 mm, two layers, and 1.6 mm thick. If you want to change the design, open releaf.kicad_pro in KiCad 10.
When using the board, switch it OFF before connecting USB, and unplug USB before switching it back ON.
Shell
A two-part printed shell holds the board and clips onto a panel with a standard linker. The files and print notes are in hardware/shell.
| Front | Back |
|---|---|
 |  |
Next to the original Nanoleaf controller (top):
| From the front | At an angle | From the side |
|---|---|---|
 |  |  |
Credits
The firmware is WLED, with a Shapes usermod adapted from Cptmeme's Nanoleaf Shapes controller for the ESP32-C3 SuperMini. WLED provides the effects, presets and web interface.
MyrikLD's LeafBus documents the panel communication in PROTOCOL.md.
License
The original Releaf hardware and project files are MIT licensed. The Shapes usermod keeps its upstream GPL-3.0 license.
Parts
6| Qty | Value | Footprint | References |
|---|---|---|---|
| 1 | 10k | Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_Horizontal | R1 |
| 1 | 33uF / 100V | Nanoleaf:CP_Radial_D8_L11.5_Horizontal | C1 |
| 1 | ESP1010 | Nanoleaf:ESP1010 | SW1 |
| 1 | ESP32-C3 SuperMini | Nanoleaf:ESP32_C3_SuperMini | U2 |
| 1 | PCB contacts | Nanoleaf:Panel_Contacts | J1 |
| 1 | Pololu D45V5F5 | Nanoleaf:D45V5F5 | U1 |
Questions
How big is the Releaf PCB?
It measures 80 × 20 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Releaf use?
6 parts, built around the ESP1010. 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 Releaf KiCad files?
From the nikolak/releaf repository on GitHub, at the commit this page was made from: the board is hardware/releaf.kicad_pcb and its schematic hardware/releaf.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Releaf 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).
Similar boards
- 2 layers14.6 × 33 mm
- 2 layers9 × 9 mm
Dpoint
Jcparkyn/dpoint
Open-source digital stylus using camera tracking and inertial measurements
6 parts1.1kMIT - 2 layers51.5 × 16.6 mm
MicroswitchXY Endstop
VoronDesign/Voron-Hardware
Cool Hardware designed by the Voron Design group
6 parts1.1kGPL-3.0 - 2 layers21.9 × 76.7 mm
Amiga External
hoglet67/RGBtoHDMI
Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI
6 parts1kGPL-3.0 - 2 layers88.9 × 50.8 mm
Businesscard
hackclub/OnBoard
💡 Join 1,000 teenagers and make your first PCB with a $100 grant!
6 parts915 - 2 layers20.3 × 15.2 mm
L0 RGB led
Luos-io/luos_engine
Open-source and real-time orchestrator for cyber-physical-systems, to easily design, test and deploy embedded applications and digital twins.
6 parts546MIT - 2 layers9 × 3.6 mm
