Skip to the content
2 layers79 × 66 mmBoard qr code 2, the printed circuit board in 3D

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.md

VR 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 ViewPCB 3D Back View2D Routing & Ground Plane
PCB 3D Front ViewPCB 3D Back ViewPCB 2D Layout Routing
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:

  1. Git - only needed when cloning the repository.

  2. Node.js LTS - install the LTS release, then open a new PowerShell window and confirm it works:

    powershell
    node --version
    npm --version
  3. 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
  4. 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:

powershell
cd "C:\path\to\VR Mania PoS Kuwait"
npm install

Configure 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:

env
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=8787

The 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:

powershell
npx supabase start

On 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:

powershell
npm run tunnel:supabase

Copy 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:

powershell
npm run dev

This starts both services:

  • POS web app: Vite prints its local URL, usually http://localhost:5173.
  • WhatsApp API: http://localhost:8787 by default.

Open the Vite URL in a browser.

Everyday commands

powershell
# 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 lint

Troubleshooting

  • Cannot connect to the Docker daemon: start Docker Desktop and wait until it is fully running, then run npx supabase start again.
  • ngrok is not recognized: install ngrok, close and reopen PowerShell, and run ngrok config add-authtoken ....
  • Frontend cannot connect to Supabase: verify Supabase is running with npx supabase status, then confirm VITE_SUPABASE_URL and VITE_SUPABASE_ANON_KEY in .env. Restart npm run dev after changing .env.
  • WhatsApp sending fails: make sure all four TWILIO_* values are in .env and that the Twilio WhatsApp sender and content template are active.

Parts

5
QtyValueFootprintReferences
1BUTTONConnector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalJ4
1Conn_01x03_PinConnector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_VerticalJ3
1LOGOSYMB:SYMBOLEG***
1RELAYPLACERELAYPERSO:RELAYPLACERELAY 5V
1~ESP32_Footprints:ESP32_30pin2U1

Similar boards

  • 2 layers98 × 27 mmXy limit, the printed circuit board in 3D

    Xy limit

    opulo-inc/lumenpnp

    The LumenPnP is an open source pick and place machine.

    5 parts3.7k
  • 2 layers21 × 33 mm24g2usb pico2w, the printed circuit board in 3D

    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 mmA10 OLinuXino Lime Rev B SHIELD TEMPLATE, the printed circuit board in 3D

    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 mmMain control board servo tester, the printed circuit board in 3D

    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 mmKiCadTest, the printed circuit board in 3D

    KiCadTest

    hackclub/OnBoard

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

    5 parts915
  • 2 layers50 × 23 mmMiniCircuits LTCC, the printed circuit board in 3D

    MiniCircuits LTCC

    VanceVagell/kv4p-ht

    Open source handheld ham radio project KV4P-HT

    5 parts828GPL-3.0
  • 2 layers20.3 × 15.2 mmL0 light sensor, the printed circuit board in 3D

    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.