https://github.com/coastie-uk/convention-auction
Web app for managing auctions at conventions with submission, slide generator, bid and payment tools. With SumUp integration
https://github.com/coastie-uk/convention-auction
auction auction-system charity conventions fandom furry live mylittlepony nodejs payment presentation-slides
Last synced: 4 months ago
JSON representation
Web app for managing auctions at conventions with submission, slide generator, bid and payment tools. With SumUp integration
- Host: GitHub
- URL: https://github.com/coastie-uk/convention-auction
- Owner: coastie-uk
- License: gpl-3.0
- Created: 2025-06-27T16:09:47.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2026-02-11T01:31:59.000Z (4 months ago)
- Last Synced: 2026-02-11T05:55:44.954Z (4 months ago)
- Topics: auction, auction-system, charity, conventions, fandom, furry, live, mylittlepony, nodejs, payment, presentation-slides
- Language: JavaScript
- Homepage: https://coastie-uk.github.io/convention-auction/
- Size: 11.9 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# convention-auction
Web platform to collect, manage, present, record bids and take payment for items at the kind of auctions often encountered at fan conventions. The use case may vary slightly from con to con, but generally looks like this:
- Attendees submit items before / during the event
- A live auction is held, using a slide deck to show items
- Attendees bid on items by holding up a paddle card
- Attendees pay for and collect their won items.
This software provides a single platform which automates the process from item submission through to payment. This now includes integration with the SumUp merchant platform allowing payments to be taken and recorded through the platform.
## Features
- Supports multiple simultaneous auctions with managed state lifecycle
- Public item submission (with optional photo) & QR code support
- Admin panel to add, edit, delete, and manage items, including image rotate/crop
- Bid recording view with undo function
- Cashier panel to record payments
- Integration with SumUp supporting web hosted checkouts and app payments with a card reader.
- Maintenance tools: manage auctions, logs, auditing, import/export, auto-create test items, etc.
- User accounts with username/password login and per-user role assignment (`admin`, `cashier`, `maintenance`, `slideshow`)
- Automatic PowerPoint generation from custom templates (slide deck + item cards)
- Auto-updating slideshow for in-venue advertising
- Automatic randomised item & bid generators (for testing/training/evaluation)
- Mobile-friendly interfaces
## System Requirements
- Linux server (developed on Mint)
- Root/sudo access for installation (runs as normal user)
- A registered domain name pointing to your server's IP address
- For SumUp payments, a SumUp merchant account and card reader
## Stack
- Node.js + Express
- SQLite (via better-sqlite3)
- Plain HTML, CSS, JS
- Hosted via a webserver of your choice (insturctions included for Apache + HTTPS + Let's Encrypt)
## Installation
For general server setup see installation.md
For payment setup see sumup_setup.md
For Powerpoint template setup see pptx_template_editing.md
## Quick-start
see quickstart.md