How poppix works — Branded event photo walls explained

Admin documentation

How poppix works

A complete walkthrough — from creating a venue to running a live event. Read once before setup. Refer back during events.

Overview

The concept

poppix is a branded event photo wall. Guests scan a QR code, which opens a camera app in their mobile browser — no download required. They shoot a photo, optionally apply one of your branded frames, and submit it to the live gallery. The gallery appears on any screen you point at the gallery URL.

Registered guests compete for upvotes. You collect their contact details. Your branding travels with every photo they share.

◎

Nothing to install on guest phones

The camera app is a Progressive Web App. It runs in Safari or Chrome on any modern phone.

Overview

System structure

One installation supports unlimited venues. Each venue gets a unique slug that drives all its URLs.

Component	URL	Who uses it
Beta landing page	https://poppix.media/	New venues enquiring about access
Camera app	https://poppix.media/app/?v=SLUG	Guests at the event — this is the QR destination
TV gallery wall	https://poppix.media/gallery/?v=SLUG	Your TV or projector — runs unattended
Venue admin	https://poppix.media/admin/?v=SLUG	Venue staff — moderation, frames, settings
Master admin	https://poppix.media/master/	You — create venues, manage all accounts

Step 1

Create a venue

Go to the Master Admin and use the Create New Venue button. The wizard walks you through four steps.

Venue name

The full name — e.g. The Crown Hotel. Appears in the app header until you upload a logo.

URL slug

Lowercase, hyphens only — e.g. crown-hotel. Becomes part of every URL. Cannot be changed once guests have used it.

Admin credentials

Username and password for venue staff to log into their admin panel. Share with your on-site contact.

Step 2

Configure the event

Open the venue admin → Settings tab.

Field	Where it appears
Event name	App loading screen, gallery header, browser tab
Event tagline	Gallery wall header
Prize / CTA	Registration panel in the app
Primary color	Buttons, highlights, active states in the app

◎

Toggle switches in Settings

Gallery live — controls whether photos appear on the TV wall.
Auto-approve registered users — registered guests skip the moderation queue.
Show leaderboard — leaderboard slides in over the TV gallery every 60 seconds.

Step 3

Upload your logo

Open the venue admin → Frames tab. Tap the logo upload area at the top.

Accepted formats

PNG, JPG or SVG. PNG with transparent background works best — it sits over the dark app header without a white box around it.

Where it appears

Top centre of the camera app, and in the gallery wall header. A wide horizontal lockup works better than a tall badge — max display height is about 36px.

✓

No logo?

The app falls back to displaying the venue name as text. Perfectly usable for a quick setup.

Step 4

Upload frame overlays

Frames are PNG overlays with a transparent centre and your branding around the edges. Up to 4 styles per orientation — 12 frames total per venue.

PORT

Portrait

720 × 1280 px

LAND

Landscape

1280 × 720 px

Square

1080 × 1080 px

⚠

File format matters

Frames must be PNG or WebP. JPEG does not support transparency — a JPEG frame will cover the photo with a solid background.

✓

Design tips

Keep the transparent centre at least 60% of the canvas. Place branding in a strip at the bottom. Test your frame over a variety of light and dark photos before the event.

Step 5

Generate your QR code

The QR code points guests to the camera app URL for your venue:

https://poppix.media/app/?v=YOUR-SLUG

Replace YOUR-SLUG with your venue slug. Generate the QR code using any free tool — qr.io, qrcode-monkey.com, or Canva. Download as SVG or high-res PNG for print. Minimum size: 3×3cm. Test before the event.

→

Scans to

https://poppix.media/app/?v=YOUR-SLUG

→

Guest sees

Camera app opens instantly. No download.

Step 6

Launch the gallery wall

Open this URL in a browser on your TV or projector:

https://poppix.media/gallery/?v=YOUR-SLUG

Go fullscreen

Press F11 or use the browser's fullscreen mode. The gallery fills the screen with no browser chrome.

Leave it running

The gallery polls for new photos every 5 seconds. No refresh needed. The leaderboard slides in automatically every 60 seconds.

⚠

Gallery live toggle

Photos only appear if Gallery live is turned on in Settings. Check this before your event starts.

Feature

The camera app

Control	What it does
Flip button (top left)	Switches front and rear camera. Front camera is mirrored so selfies look natural.
Mode strip (top centre)	Portrait / Landscape / Square — switches aspect ratio. Frame carousel updates automatically.
Frame carousel (bottom)	Circular thumbnails of available frames. The + (no frame) option is always first.
Shutter button (centre)	Takes the shot. Frame is composited client-side — only the final framed JPEG is uploaded.
Gallery icon (bottom left)	Opens the live gallery panel — guests can browse and upvote.
Person icon (bottom right)	Opens the registration panel. Turns red when registered.

After capture: Share (native share sheet), Retake, or Keep without sharing.

Feature

Player registration

Registration is optional. Unregistered guests can still shoot — their photos go to the moderation queue. Registered guests are auto-approved (if that toggle is on) and appear on the leaderboard.

Field	Required	Notes
Name	✓	Displayed on the leaderboard
Email	✓	Used to identify repeat visitors across sessions
Instagram	—	Stored in player record
TikTok	—	Stored in player record
Facebook	—	Stored in player record
Marketing consent	—	Exported with player list

◎

When guests are prompted to register

If a guest taps Share and is not yet registered, the registration panel opens first. After registering, sharing proceeds automatically.

Feature

Moderation

The Queue tab in venue admin shows all photos awaiting approval — typically from unregistered guests.

Approve

Photo goes live on the gallery wall immediately.

Delete

Photo is removed. Use for anything inappropriate. The guest is not notified.

Turn on Auto-approve registered users in Settings to skip moderation for registered guests entirely.

Feature

TV gallery wall

Element	Behaviour
Header	Venue logo or name, event name and tagline, live photo and player count
Photo wall	Masonry grid — 4 columns on widescreen. New photos animate in with a New badge for 8 seconds.
Polling	Checks for new approved photos every 5 seconds. Automatic — no page refresh.
Bottom strip	Live indicator and the app URL — a prompt for newcomers
Click to expand	Click any photo to expand it fullscreen.
Auto-trim	After 100 photos, oldest cards are removed from the display (remain in database).

Feature

Leaderboard

When Show leaderboard is enabled, a leaderboard panel slides in from the right side of the TV gallery every 60 seconds, stays for 15 seconds, then retracts. It shows the top 10 registered players by total upvotes.

Guests upvote photos by tapping any photo in the gallery panel. One vote per photo per session.

✓

Driving competition

Announce the prize at the start of the event. The leaderboard appearing on screen creates natural urgency — guests vote for friends or shoot more to improve their own standing.

Reference

URL reference

Purpose	URL
Guest camera app (QR destination)	`https://poppix.media/app/?v=SLUG`
TV gallery wall	`https://poppix.media/gallery/?v=SLUG`
Venue admin panel	`https://poppix.media/admin/?v=SLUG`
Master admin	`https://poppix.media/master/`
This guide	`https://poppix.media/help/`

Reference

Frame spec summary

Orientation	Pixel size	Aspect ratio	Typical use
Portrait	720 × 1280 px	9:16	Standard phone photo, Stories format
Landscape	1280 × 720 px	16:9	Group shots, event signage style
Square	1080 × 1080 px	1:1	Instagram feed, Polaroid style

PNG or WebP only. Transparent background required. Keep files under 1MB for fast load on mobile.