How to Build a Cyberdeck: Hardware, Parts and a Full Build Guide (2026)

A cyberdeck is a portable computer you build, or at least customize, to look and work exactly the way you want: a screen, a keyboard, a battery and a brain, packed into a rugged case, a 3D printed shell or something found at a flea market. The look gets the attention, but the hardware decides whether it works. This guide goes through every layer of a real build: which brain to pick (ESP32, Pi Zero 2 W, Pi 5 or a Compute Module), screens, power and battery life, modules on the GPIO header, the shell, heat, and three complete parts lists with 2026 prices.

1. What is a cyberdeck?
2. Cyberdeck build ideas: decide the job first
3. How the parts fit together
4. Choosing the brain: ESP32 vs Raspberry Pi
5. Screens and keyboards
6. Power and battery life
7. I/O and modules on the GPIO header
8. The shell: five ways to build the case
9. Thermal basics
10. Cyberdeck build list: three builds with prices
11. Cyberdeck kits and decks for sale
12. Software
13. Cyberdeck build guide, step by step

What is a cyberdeck?

The word comes from William Gibson's 1984 novel Neuromancer, where hackers "jack in" to cyberspace through portable consoles called decks. Gibson described them only loosely: portable, personal, and usually modified by their owners. That vagueness is exactly why the idea stuck. Anyone can decide what their deck looks like.

The modern hobby took off around 2019, when maker Jay Doscher built his Raspberry Pi Recovery Kit: a rugged computer in a hard-shell case with a small display, a mechanical keyboard and a milled aluminum faceplate. Since then Hackaday has run dedicated cyberdeck contests, communities like r/cyberDeck have filled up with builds, and decks range from military-looking field kits to wooden retro terminals and pocket handhelds.

What makes something a cyberdeck rather than a small laptop is intent: it is built for a purpose, usually with hardware a laptop does not have (a radio, a sensor, physical switches), and it looks like it was made by its owner.

Cyberdeck build ideas: decide the job first

The most common mistake is starting with the case. Start with what the deck is for, because the job decides the brain, and the brain decides the power, the heat and the size of everything else. Here are six builds people actually make, and what each needs.

A useful test from our ESP32 vs Raspberry Pi guide: if you can describe the deck in one sentence without the word "computer" ("a LoRa messenger", "a synth"), it is a microcontroller job. If the sentence is "a tiny Linux box", it is a Pi job.

How the parts fit together

Every cyberdeck, from a pocket handheld to a briefcase, is the same five blocks: power, a brain, a screen, input, and I/O. The diagram shows how they connect and which bus each part uses.

Choosing the brain: ESP32 vs Raspberry Pi

There are two families of brain, and they are very different things. An ESP32 is a microcontroller: it runs one program the instant it gets power, keeps precise timing, and sleeps on microamps. A Raspberry Pi is a Linux computer: it boots an operating system and runs a desktop, a browser, Python and SSH, and it draws watts, not microamps.

Pi 5 power figures are independent third-party measurements; prices are official list prices, checked October 2026.

When to use a Raspberry Pi 5

The Pi 5 is the first Pi that feels like a comfortable everyday desktop: a quad-core Cortex-A76 at 2.4 GHz, PCIe for an NVMe SSD through the M.2 HAT+ (from $12), dual 4Kp60 HDMI, a real-time clock and a power button. It is the right brain when the deck needs:

• A smooth desktop and a real browser with several tabs open.
• SDR and signal work, where decoding radio in software wants CPU and RAM.
• Fast storage: an NVMe drive instead of a microSD card.
• Emulating newer consoles, local AI experiments or containers.

When not to

The Pi 5 has become expensive. Raspberry Pi raised prices in December 2025, February 2026, April 2026 and again on October 1, 2026, blaming memory costs, and calls the increases temporary. Current list prices are $45 (1GB), $77.50 (2GB), $110 (4GB), $175 (8GB) and $305 (16GB); the Pi 4 is $35, $67.50, $100 and $165 for 1, 2, 4 and 8GB. The full story is in our Raspberry Pi price increase guide. Skip the big Pi 5 when:

• The deck does one job. A messenger, synth or tool runs better on an ESP32 that is on instantly and lasts far longer on a battery.
• It is a text-first terminal. SSH, tmux and a text editor do not need 8GB. A Pi 5 with 1GB or 2GB ($45 or $77.50) gives you the speed without paying for memory, and a Zero 2 W does it on much less power when you can find one.
• Battery life matters more than speed. A Pi 5 idles at around 3 W before you add a screen.

The Compute Module 5 (from $67.50) is the Pi 5's brains on a small module with no ports of its own. It plugs into a carrier board, which is how many polished decks and ready-made kits work: the carrier puts the connectors exactly where the case needs them. The full comparison, including the Pico, Arduino and a mini PC, is in ESP32 vs Raspberry Pi: when you really need a Pi 5.

Screens and keyboards

The screen and the keyboard are the two biggest parts and the two you touch, so they set the size and shape of the whole deck. Buy them before you design anything.

• DSI or HDMI? The official Touch Display 2 uses a flat DSI ribbon and takes its power from the GPIO header, so there is no bulky HDMI plug and no extra cable. It needs a Pi with a DSI connector; the Zero 2 W has none, so Zero decks use HDMI screens through its mini HDMI port.
• Portrait panels. The Touch Display 2 panels are natively portrait (720 x 1280). Raspberry Pi OS can rotate the picture for a landscape deck.
• Microcontroller screens are different: an ESP32 drives small SPI screens directly, which is why pocket decks have built-in displays rather than HDMI.

Keyboards. Compact 40% or 60% mechanical boards are the classic cyberdeck look; small wireless keyboards are the quickest route. A keyboard with a detachable cable makes the layout far easier, and a USB keyboard is one less thing to charge. For pocket decks, the keyboard is built in: the Cardputer ADV has 56 keys on a board smaller than a phone.

Power and battery life

Power is where most first builds struggle, especially with a Pi 5. The two usual choices are a USB-C PD power bank (simple, safe, charges like a phone) or a UPS board with 18650 cells (sits inside the case, keeps the Pi running while you swap to wall power).

• Know what the board wants. The Pi 5's official supply is 27 W (5V at 5A). On an ordinary 3A supply it limits USB peripherals to 600 mA in total, which catches out decks running a keyboard, an SSD and a radio from the Pi's own ports. Many power banks do not offer 5V at 5A, so plan for that limit or use a powered hub.
• An ESP32 deck is easy. It runs from a small lithium cell and can deep sleep on microamps. The Cardputer ADV has a 1750 mAh battery built in.
• Charge from outside. A panel-mount USB-C charging port means you never open the case to top it up.

How long will it run? The estimate

You can estimate battery life with one line of arithmetic: hours ≈ battery watt-hours ÷ deck watts. Battery watt-hours are the rated mAh times the cell voltage, divided by 1,000.

1. Battery: a 10,000 mAh power bank at 3.7V nominal holds about 10,000 × 3.7 ÷ 1,000 = 37 Wh.
2. Deck: a Pi 5 sitting near idle draws about 3 W, and a small screen adds a few watts more. Call it around 6 W for the sake of the sum.
3. Divide: 37 ÷ 6 ≈ 6 hours on paper.
4. Subtract losses: converting the 3.7V cells up to 5V wastes some energy, and batteries rarely deliver every rated milliamp-hour. Plan on noticeably less, very roughly 4 to 5 hours of light use. Under heavy load (7 to 9 W for the Pi alone) expect a lot less.

I/O and modules on the GPIO header

The 40-pin header is what turns a small computer into a cyberdeck. It carries power pins, plain GPIO pins for switches and LEDs, and three buses that almost every module uses: I2C (lots of simple devices on two wires), SPI (fast: screens and radios) and UART (serial text, like GPS). Pick a module, check its bus, and you know which pins it goes to.

The full pinout, which pins carry I2C, SPI and UART, and what changed on the Pi 5 (old RPi.GPIO code needs gpiozero or rpi-lgpio) are in our Raspberry Pi GPIO pinout guide.

The shell: five ways to build the case

Whatever the shell, the same details decide whether it works: design around the screen and keyboard first, mount the board on M2.5 standoffs (with heat-set inserts in printed cases), put the heavy battery low, use panel-mount USB-C and antenna jacks, and mock it up in cardboard before you cut anything. PETG is the sensible default filament for a finished printed deck. Our cyberdeck case ideas guide covers each case type, filaments, Pi 5 mounting dimensions and where to find STL files. For the look (colors, labels, wear), the cyberpunk room decor guide has palettes that work on a deck too.

Thermal basics

• The Pi 5 needs a fan. Raspberry Pi recommends active cooling, and the chip throttles back at around 80 to 85°C.
• A cooler only moves heat into the case. In a closed box that air just gets hotter. Give it an intake low down and an exhaust high up, with the fan's path clear.
• Keep hot parts off plastic. PLA starts to soften around 60°C, well below what the Pi's chip is allowed to reach. Use PETG or ASA near heat, and never leave a PLA deck in a hot car.
• Mind the battery. Lithium cells do not like heat. Keep them away from the board and the exhaust.
• Microcontroller decks run cool. An ESP32 deck rarely needs any cooling at all, which is one more reason pocket decks are so simple to build.

Cyberdeck build list: three builds with prices

Three tiers, from a pocket deck to a full field computer. Prices are official list prices checked October 2026; "varies" means the part comes in many versions at very different prices, so check what you pick.

1. Pocket ESP32 deck

No case to design, no power to solve: the deck is done, and the fun is in the firmware. Our guide to Cardputer ADV firmware and apps covers what it can run.

2. Budget Linux deck

3. Full Raspberry Pi 5 field deck

Building around a Compute Module 5 instead? It starts at $67.50, but you also need a carrier board, and the carrier decides the rest of the parts list.

Cyberdeck kits and decks for sale

There is no single standard "cyberdeck kit", but a few products get you most of the way without designing a case:

ClockworkPi uConsole

Kit

A kit with a 5" 720p IPS screen, a backlit QWERTY keyboard and a battery module, built around a Raspberry Pi CM4 (and compatible modules). You assemble it, then customize the software. See ClockworkPi's uConsole page for current pricing.

A kit is the right choice if you want to use a deck more than build one. Building from parts is the right choice if the build is the point.

Software

• Raspberry Pi OS is the default for Pi decks. The Lite version (no desktop) boots to a terminal and saves power and memory on a text-first deck; the full version gives you a desktop and browser.
• SSH lets you set the deck up from another computer before the keyboard and screen are even mounted, and lets the deck reach your servers from anywhere.
• tmux and terminal apps (editors, file managers, system monitors, chat and mail clients) make a small screen feel much bigger: split panes beat overlapping windows at 5 inches.
• GPIO code: the gpiozero Python library drives switches, LEDs and many modules, including on the Pi 5.
• ESP32 decks run one firmware at a time: you flash an app (Meshtastic, a synth, a tool) and swap when you want something else.

Cyberdeck build guide, step by step

1. Write down the job. One sentence. It decides whether you need an ESP32, a Zero 2 W, a Pi 5 or a Compute Module.
2. Buy the screen and keyboard. Measure them for real, including cables and connectors. They set the size of everything.
3. Bench-test the electronics. Brain, screen, keyboard and every module wired up on a table, running the software you actually plan to use.
4. Measure the power. Put a USB power meter inline, read the real watts, and size the battery with the watt-hour sum above.
5. Choose and plan the case. Lay everything out at 1:1 on paper, plan airflow and where the ports and antennas exit, then mock it up in cardboard.
6. Build the shell. Print, cut or modify it, with standoffs for the board and brackets (not glue) for the battery.
7. Install and wire. Panel-mount ports, route cables with slack through any hinge, antennas outside, fan path clear.
8. Run it hot. Load it for an hour with the lid closed and check temperatures before you trust it in a bag.
9. Iterate. Your first deck will teach you what you want in your second. Almost every builder makes more than one.

The music deck in your pocket

Full disclosure: this one is ours. We make GLIDE, a synthesizer that turns a Cardputer ADV into a pocket music deck, so in a way we build tiny cyberdecks for a living. It is a microcontroller job for exactly the reasons above: it plays the instant you switch it on, every note lands on time, and it runs on the built-in battery. The keyboard becomes four rows tuned like strings, notes slide into each other, and it can listen to a song and retune itself to its key. You can play it right below, in your browser.