Overview
Core features
- Multiple simultaneous auctions with managed lifecycle states.
- Public item submission with optional photos and QR support.
- Admin tools for editing, photos, moving items, and exports.
- Automatic PowerPoint slide deck and item card / slip generation with customisable templates
- Live bid recording with undo and running totals.
- Cashier panel to collate bidders' items, handle payments and refunds
- Auto-updating slideshow for in-venue displays.
- SumUp payment integration (web checkout and card reader).
Stack
- Node.js + Express backend.
- SQLite via better-sqlite3.
- Plain HTML, CSS, JS frontend.
Requirements
- Linux server with sudo access for setup
- Domain name pointing to your server.
- SumUp merchant account for card payments.
Description
Public Submission
Intake form for attendees. Supports QR short-name routing.
- Use ?auction=shortname to auto-select an auction.
- Item description and contributor are required.
- Optional photo upload
- Mobile-friendly capture or gallery upload.
Admin Panel
Manage items, record bids, and generate exports for the live auction.
- Create, edit, reorder, and delete items.
- Rotate, crop, and replace item photos.
- Move items between auctions
- Record bids with undo support.
- Generate auction slides and item cards.
- Launch public intake, live feed, cashier, and maintenance pages.
Cashier Panel
Close out balances, manage refunds, and track payment methods.
- List bidders, totals due, and settlement status.
- Supports cash, PayPal, manual card, or SumUp payments.
- Payment methods can be enabled/disabled in server setup
- Payment operations are logged for audit trail
- View detailed payment history and issue refunds.
- Export CSV summaries by bidder and payment method.
Live Feed
Real-time view of finalized bids to help organize winning lots.
- Shows paddle number, lot, title, and hammer price.
- Filter by paddle or include unsold items.
- Updates automatically as bids are taken.
- Hover lot titles to preview photos.
Maintenance Panel
Full control over auctions, data management, templates, and diagnostics.
- Create and manage auctions and states.
- Import/export CSV, back up or restore the database.
- Automatically generate test items and bids.
- Manage PowerPoint templates and image resources.
- Review audits and backend logs.
- Manage passwords
Slideshow
Unattended full-screen slideshow with live updates from the server.
- Configurable overlays for description, contributor, creator.
- Keyboard and touch controls for pause, resume, and settings.
- Auto-refreshes items as new photos are added.
- No stored credentials - Safe to leave unattended
