

Board qr code 2
Point of Sale & Automated Hardware Controller for VR Amusement Rides (Kuwait).
- Size
- 79 × 66 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 5
- Nets
- 30
- Pads
- 35
- Tracks, vias
- 27, 0
- Pours
- 1
- Routed
- Yes
- KiCad
- KiCad 10.0 (file 20260206)
- Created
- 26 Sep 2026
- Updated
- 26 Sep 2026
Overview
Board qr code 2 is an open-source printed circuit board by NEDEER, from the NEDEER/VR-Mania-QRCODE- repository on GitHub. It is a 2-layer board of 79 × 66 mm with 5 parts on 30 nets, routed with 27 tracks and 0 vias.
Its parts include 2 connectors and 1 IC.
README
readme.mdVR Mania POS Kuwait
Point of Sale & Automated Hardware Controller for VR Amusement Rides (Kuwait).
🛠️ Custom Hardware & Controller PCB Design
The automated ride activation is powered by a custom ESP32 + Relay Carrier Board designed in KiCad:
| PCB 3D Front View | PCB 3D Back View | 2D Routing & Ground Plane |
|---|---|---|
![]() | ![]() | ![]() |
| Face Avant (3D) ESP32 Socket & 5V Relay Module | Face Arrière (3D) Bottom Copper Routing & Solder Mask | PCB Routing (2D) 1.0mm Power Traces & Solid GND Plane |
Hardware & System Architecture:
- Handheld POS Terminal: KPOS-NB57 (Android PDA with QR Barcode Scanner & Bluetooth).
- Ride Controller: ESP32 Development Board (NodeMCU-32S) with 60-second runtime timer.
- Actuator: 1-Channel 5V Relay module (
SRD-05VDC-SL-C) wired to the machine enable contact. - Manual Override: External momentary push button (
GPIO 13) for immediate operator stop/cancel. - PCB Manufacturing: 2-Layer FR4 with double-sided GND copper pour and M3 mounting holes.
What you need
Install these before starting the project:
-
Git - only needed when cloning the repository.
-
Node.js LTS - install the LTS release, then open a new PowerShell window and confirm it works:
powershell node --version npm --version -
Docker Desktop - install it, accept the WSL 2 setup if prompted, then start Docker Desktop and wait until it says it is running. Confirm Docker is available:
powershell docker --version -
ngrok - create a free ngrok account, install ngrok, and add its authentication token:
powershell ngrok config add-authtoken YOUR_NGROK_AUTHTOKEN
Get the project
Copy the project folder to the new computer, or clone it with Git. In PowerShell, open the project folder and install the JavaScript dependencies:
cd "C:\path\to\VR Mania PoS Kuwait"
npm installConfigure environment variables
Ask the project owner for the existing .env file and place it in the project root. Do not commit or share this file because it contains credentials.
For a local Supabase database, start Supabase once using the command in the next section. It prints the values to use for the frontend. Add or update these lines in .env with the values shown in the command output:
VITE_SUPABASE_URL=http://127.0.0.1:54321
VITE_SUPABASE_ANON_KEY=YOUR_LOCAL_SUPABASE_ANON_KEY
# Required only when sending WhatsApp receipts
TWILIO_ACCOUNT_SID=YOUR_TWILIO_ACCOUNT_SID
TWILIO_AUTH_TOKEN=YOUR_TWILIO_AUTH_TOKEN
TWILIO_WHATSAPP_NUMBER=whatsapp:+00000000000
TWILIO_CONTENT_SID=YOUR_TWILIO_CONTENT_SID
# Optional. The API uses 8787 when this is not set.
API_PORT=8787The Supabase URL above is fixed by supabase/config.toml. Copy the local anon key from the npx supabase start output, or run npx supabase status after Supabase is already running.
Start the project
Open three PowerShell windows in the project root.
1. Start local Supabase
Make sure Docker Desktop is running, then run:
npx supabase startOn the first run this downloads Docker images, so it can take a few minutes. This starts the database, API, storage, authentication, and Supabase Studio. The database schema is applied automatically from supabase/migrations.
Useful local addresses:
- Supabase API:
http://127.0.0.1:54321 - Supabase Studio:
http://127.0.0.1:54323
2. Expose Supabase through ngrok
Keep the Supabase window open, then run:
npm run tunnel:supabaseCopy the HTTPS forwarding URL that ngrok displays. The POS uses this public address when it needs to generate externally accessible receipt links. Keep this window open while testing that flow.
3. Start the POS web app and API
Run:
npm run devThis starts both services:
- POS web app: Vite prints its local URL, usually
http://localhost:5173. - WhatsApp API:
http://localhost:8787by default.
Open the Vite URL in a browser.
Everyday commands
# Stop Supabase and keep its database data
npx supabase stop
# View Supabase URLs and keys while it is running
npx supabase status
# Rebuild the local database and rerun migrations (erases local data)
npx supabase db reset
# Check TypeScript types
npm run typecheck
# Run linting
npm run lintTroubleshooting
Cannot connect to the Docker daemon: start Docker Desktop and wait until it is fully running, then runnpx supabase startagain.ngrok is not recognized: install ngrok, close and reopen PowerShell, and runngrok config add-authtoken ....- Frontend cannot connect to Supabase: verify Supabase is running with
npx supabase status, then confirmVITE_SUPABASE_URLandVITE_SUPABASE_ANON_KEYin.env. Restartnpm run devafter changing.env. - WhatsApp sending fails: make sure all four
TWILIO_*values are in.envand that the Twilio WhatsApp sender and content template are active.
Parts
5| Qty | Value | Footprint | References |
|---|---|---|---|
| 1 | BUTTON | Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_Vertical | J4 |
| 1 | Conn_01x03_Pin | Connector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_Vertical | J3 |
| 1 | LOGO | SYMB:SYMBOLE | G*** |
| 1 | RELAYPLACE | RELAYPERSO:RELAYPLACE | RELAY 5V |
| 1 | ~ | ESP32_Footprints:ESP32_30pin2 | U1 |
Similar boards
- 2 layers98 × 27 mm

- 2 layers21 × 33 mm

24g2usb pico2w
joypad-ai/joypad-os
Universal controller firmware for building adapters, dongles, and custom controllers.
5 parts1.7kApache-2.0 - 2 layers53.2 × 59.6 mm

A10 OLinuXino Lime Rev B SHIELD TEMPLATE
OLIMEX/OLINUXINO
OLINUXINO is Open Source / Open Hardware, low cost from EUR 24 Linux Industrial grade Single Board Computer capable to operate -25+85C
5 parts1.5k - 2 layers30 × 11 mm

Main control board servo tester
jamro/tiny-engineer
A small desktop robot that brings an AI coding assistant to life, physically acting out when it reads files, thinks, writes code, and finishes work.
5 parts1.1k - 2 layers78.8 × 35.3 mm

KiCadTest
hackclub/OnBoard
💡 Join 1,000 teenagers and make your first PCB with a $100 grant!
5 parts915 - 2 layers50 × 23 mm

- 2 layers43.2 × 28.5 mm

- 2 layers20.3 × 15.2 mm

L0 light sensor
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.
5 parts546MIT
Questions
How big is the Board qr code 2 PCB?
It measures 79 × 66 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Board qr code 2 use?
5 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 Board qr code 2 KiCad files?
From the NEDEER/VR-Mania-QRCODE- repository on GitHub, at the commit this page was made from: the board is board qr code 2/board qr code 2.kicad_pcb and its schematic board qr code 2/board qr code 2.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Board qr code 2 design in my own project?
Its repository states no licence, so its author keeps all rights: ask NEDEER before reusing the design.


