zpin

Offline prize wheel app for Windows — spin to win at events, trade shows, and promotions.

zpinwheel.download

Features

• Canvas-rendered prize wheel with smooth spin animations and natural deceleration
• Velocity-driven tick audio — louder and higher-pitched when fast, softer as the wheel slows
• Weighted probability per prize segment with live percentage display
• Prize inventory tracking (finite quantities, auto-greyed when depleted)
• Confetti emoji celebration on every win
• Admin panel for live configuration (prizes, colors, logo, background, gradient)
• USB clicker / presentation remote support (PageDown triggers spin)
• Fully offline — no internet required after install
• Persistent configuration across sessions (%APPDATA%/zpin/config.json)

Controls

Admin Panel

Press Ctrl+Shift+A to open the admin panel. A gear icon will appear in the top-right corner for quick access afterward.

Prizes

• Add, remove, and rename prize segments
• Set weight per prize (higher = more likely). Probability % is shown live
• Set quantity (0 = unlimited). When a prize's won count reaches its quantity, it greys out on the wheel and is excluded from future spins
• Won counter tracks how many times each prize has been won
• "Reset Won Counts" zeroes all counters without changing the prize list

Colors

• Slice Color 1 / 2 — alternating segment colors on the wheel
• Text on Color 1 / 2 — text color for each slice type

Tip: Keep an even number of prizes to ensure the two slice colors alternate cleanly. With an odd count, two adjacent slices will share the same color. The default lineup includes "Free Spin" to maintain an even 12.

Images

• Logo — displayed in the wheel's center hub. Preview always visible (custom or default Doka logo)
• Background — upload a custom background image, or use the built-in gradient
• Gradient Colors — when no custom background is set, you can customize the center and edge colors of the radial gradient

Tech Stack

Quick Start

Prerequisites: Node.js 20+, just

just install   # install dependencies
just dev       # launch with hot reload

Build Commands

Project Structure

src/
├── main/
│   └── index.ts              # Electron main process
├── preload/
│   ├── index.ts              # Context bridge (IPC)
│   └── index.d.ts            # Preload type declarations
└── renderer/
    ├── index.html
    ├── public/
    │   ├── audio/            # click, pop, fanfare sounds
    │   └── img/              # default logo
    └── src/
        ├── main.tsx          # React entry point
        ├── App.tsx           # Root component, config persistence
        ├── index.css         # Tailwind + global styles
        ├── components/
        │   ├── Wheel.tsx     # Canvas wheel + spin physics + audio
        │   ├── AdminPanel.tsx# Prize/config editor
        │   └── WinOverlay.tsx# Winner announcement + confetti
        └── lib/
            └── defaults.ts   # Default config + Prize types

Configuration

Config is stored at %APPDATA%/zpin/config.json and persists across sessions. All settings are managed through the admin panel (Ctrl+Shift+A).

Deployment

Release builds are created locally and deployed via just release && just deploy:

1. electron-vite build compiles the app
2. electron-builder packages for Windows
3. Inno Setup creates the installer .exe
4. PowerShell creates the portable .zip
5. just deploy uploads artifacts + latest.json manifest to zpinwheel.download

License

Proprietary. All rights reserved.