VoucherVault

VoucherVault is a Django-based web application for digitally storing and managing vouchers, coupons, gift cards and loyalty cards. It provides a mobile-optimized portal with scanning, barcode/QR rendering and notification capabilities for personal or small-business use.

Key Features

• Store vouchers, coupons, gift cards and loyalty cards with metadata and optional file attachments (images, PDFs)
• Display redeem codes as QR codes or many barcode formats; client-side scanning (camera or file) with automatic type detection
• Transaction history support for gift cards and basic item sharing between users
• Expiry checking and notifications via Apprise integration with configurable thresholds and schedules
• Single Sign-On support using OpenID Connect (OIDC) with options for automatic account creation
• REST API endpoint providing stats for dashboards and integrations (e.g., Home Assistant)
• Docker-ready deployment with example docker-compose stacks; supports SQLite and PostgreSQL databases
• Multi-language support and light/dark themes; optional Celery worker support for background tasks

Use Cases

• Personal organization of digital coupons, loyalty cards and gift cards with searchable, mobile-friendly access
• Small businesses or clubs tracking issued gift cards, transaction history and automated expiry reminders
• Integration with home automation or dashboard systems to surface voucher counts and expiry stats via the REST API

Limitations and Considerations

• Notifications rely on Apprise; configuring specific delivery channels requires separate Apprise setup
• Client-side scanning depends on browser/device camera support and may vary across mobile browsers
• Transaction history is limited to gift cards; other item types have more limited auditing
• Docker container runs as a low-privileged www-data user, which may require adjusting host volume permissions

VoucherVault is a focused, lightweight solution for managing digital vouchers and related items. It is suitable for personal use and small deployments that need barcode/QR handling, expiry alerts and simple integration points via OIDC and a REST API.