This is an open source project to build both the software and the hardware blueprints/build guide (incl. a kit) for public lockers to store and/or share items.
Locker is an open-source printed circuit board by Open-Locker, from the Open-Locker/Open-Locker repository on GitHub, published under the AGPL-3.0 licence. It is a 2-layer board of 112 × 72 mm with 22 parts on 20 nets, routed with 174 tracks and 0 vias.
Open-Locker is an open source software and hardware platform for public lockers used to store and share resources. The project includes the cloud services, mobile experience, on-site controller, public website, and hardware blueprints needed to run a deployment.
The project began with lockers operated by the county of Hameln-Pyrmont for lending equipment such as laptops and VR headsets. It is sponsored by Smart City Hameln-Pyrmont and developed by a community learning together while building useful public infrastructure.
The React Native mobile app uses the Laravel API to discover accessible
compartments, update their content notes, and request that a compartment open.
The backend authorizes and records those operations through event-sourced domain
workflows. It sends hardware commands over MQTT to a Raspberry Pi running
locker-client; only that client communicates with the relay boards over
serialized Modbus RTU. Laravel Reverb carries compartment updates; the current
mobile app applies live door-state and content-note changes.
See the architecture overview for system boundaries, the app communication guide for REST and realtime behavior, and the AsyncAPI contract for MQTT topics and payloads.
Open-Locker/
├── locker-backend/ # Laravel 12 API, Filament 5 admin, MQTT, and Reverb
├── locker-client/ # Raspberry Pi MQTT-to-Modbus RTU bridge and simulator
├── mobile-app/ # React Native and Expo client
├── website/ # Astro public website and published documentation
├── hardware/ # KiCad designs and build references
├── docs/ # Architecture, contracts, ADRs, and operating guides
└── Justfile # Repository task runnerThe backend runs on PostgreSQL and exposes a live Scramble-generated OpenAPI
document at /docs/api.json. The mobile app generates its RTK Query client from
that live contract.
Use the installation guide for backend and Raspberry Pi setup. Component-specific details live in:
Join our weekly meeting every Tuesday at 19:30 CET / 18:30 UTC on Discord, or participate through GitHub issues, pull requests, and feedback. New contributors are welcome to listen in, ask questions, or choose a component that interests them.
The repository is also mirrored on openCode for Public Money, Public Code publication.
We also welcome organizations interested in sponsoring or adopting open digital infrastructure for community resource sharing. Contact the project through Discord or open a GitHub issue.
Please check out the Code of Conduct to see how to properly interact with our community.
If you want to contact us, you can reach out via Discord or email us at moin@merona.de.
To report a security vulnerability, see SECURITY.md.
Open-Locker is available under the AGPL v3.
| Qty | Value | Footprint | References |
|---|---|---|---|
| 11 | Conn_01x04 | Connector_JST:JST_XH_B4B-XH-A_1x04_P2.50mm_Vertical | LOCK_1, LOCK_2, LOCK_3, LOCK_4, LOCK_5, LOCK_6, LOCK_7, LOCK_8, MODBUS_CONNECTION1, UPLINK1, WAVESHARE1 |
| 10 | Conn_01x02 | Connector_JST:JST_XH_B2B-XH-A_1x02_P2.50mm_Vertical | CH_1, CH_2, CH_3, CH_4, CH_5, CH_6, CH_7, CH_8, DC_DC1, POWER1 |
| 1 | Conn_01x08 | Connector_JST:JST_XH_B8B-XH-A_1x08_P2.50mm_Vertical | DIGITAL_INPUTS1 |
It measures 112 × 72 mm and has 2 copper layers, 1.6 mm thick.
22 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.
From the Open-Locker/Open-Locker repository on GitHub, at the commit this page was made from: the board is hardware/mtu-connection-board/locker.kicad_pcb and its schematic hardware/connection-board-cut-out_2_54/connection-board-cut-out_2_54.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Its repository publishes it under the AGPL-3.0 licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).
Open-Locker/Open-Locker
This is an open source project to build both the software and the hardware blueprints/build guide (incl. a kit) for public lockers to store and/or share items.
Open-Locker/Open-Locker
This is an open source project to build both the software and the hardware blueprints/build guide (incl. a kit) for public lockers to store and/or share items.
VoronDesign/Voron-Hardware
Cool Hardware designed by the Voron Design group
hoglet67/RGBtoHDMI
Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI
hackclub/OnBoard
💡 Join 1,000 teenagers and make your first PCB with a $100 grant!
abhishek-kakkar/BeagleLogic
A Software Suite that implements a logic analyzer with the PRU on the BeagleBone / BeagleBone Black.
Chrismettal/flipper-zero-backpacks
Backpack-style addon boards for the Flipper Zero!
CRImier/MyKiCad
My KiCad boards. Can't be bothered uploading individually anymore, so here you go.