Getting Started

This guide walks through setting up Parlevel for a new venue, from environment configuration to your first live RFID scan.

Prerequisites

• A Chainway U300 UHF RFID reader (4-port or 8-port)
• An Android tablet running the U300 Relay APK
• The Parlevel app deployed to Vercel (or running locally on port 3000)
• A Supabase project with the Parlevel schema applied

Setup steps

1. Configure environment variables

Copy .env.example to .env.local and fill in the required values. See Environment Variables for the full reference.

The minimum required set for RFID to work:

# Supabase
NEXT_PUBLIC_SUPABASE_URL=https://xxxx.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJ...
SUPABASE_SERVICE_ROLE_KEY=eyJ...
 
# U300 relay (can also be set per-location in the UI)
U300_WEBAPI_URL=http://192.168.1.100:5000
RFID_INGEST_KEY=your-secret-key

2. Install the relay APK

The U300 Relay APK runs on an Android tablet connected to the same LAN as the U300 reader. It polls the reader and forwards tag events to Parlevel.

See Relay APK Setup for installation and configuration.

3. Create a location

In the Parlevel UI:

1. Go to Locations → Add Location
2. Enter the venue name and address
3. Open the location's RFID tab and set the U300 Web API URL and Relay Token

4. Start RFID ingest

From the location's RFID tab, click Start RFID. This tells the relay to begin polling the reader and posting events. You should see tags appearing in the area management view within a few seconds.

5. Assign tags to products

In Area Management → Storeroom, scan a tag and assign it to a product. Once assigned, the product will appear in zone inventory views with live fluid levels (if using moisture-sensing tags).

Common first-run issues