repowisel4rm4nd/vouchervault

l4rm4nd / vouchervault

Django web application to store and manage vouchers, coupons, loyalty and gift cards digitally. Supports PWA, offline caching, expiry notifications, transaction histories, file uploads and OIDC SSO.

HTML★ 513
Use in your agentAsk this codebase

github.com/l4rm4nd/vouchervaultIndexed at 1046e52Up to date with upstream

What is vouchervault?

vouchervault is a Django web application for storing and managing vouchers, coupons, loyalty cards and gift cards digitally. It combines a web portal with digital item records, sharing, notifications and code display or scanning. The project uses Python, JavaScript, Django and Docker, with HTML as its primary language by file count.

Written by a model from the README and the source

76 files and 1,365 symbols in 5 modules, led by Python (53 files) and JavaScript (9).

Start reading

Code health

7.3out of 10Good

This codebase scores 7.3 out of 10 for code health, which we rate good. It also scores maintainability 8.3 and static performance 9.7 out of 10. The three are scored separately and never blended into one number. Risk is concentrated, as it usually is: 1 of 76 files are git hotspots, and they average 1.8 — which is where the fixes pay off most.

Full health report

Use l4rm4nd/vouchervault in your agent

Point Claude Code, Cursor, Codex or VS Code at this repository. Your agent gets the index this page is built from: cited answers, callers, history and health for any file.

  1. 1.In Claude, open Customize → Connectors, click +, then Add custom connector. On a Team or Enterprise plan an owner adds it first under Organization settings → Connectors.
  2. 2.Paste the server URL below as the Remote MCP server URL, then click Add.
  3. 3.Click Connect. A Repowise sign-in window opens. Approve access.
  4. 4.Repowise's tools are now available in your Claude chats.

Connect with one click. Sign in with Repowise (OAuth), no API key to copy. Works in Claude on the web, desktop, and mobile.

Docs
bash
https://api.repowise.dev/mcp/l4rm4nd/vouchervault
Editors need an API key: sign in to create one.Sign in to connect

This repo is public, so anyone with a Repowise account and an API key can connect.

Try asking

  • get_overview()
  • get_answer("how is vouchervault put together?")
  • get_why("why is vouchervault structured this way?")

Explore vouchervault

Key features of vouchervault

  • vouchervault provides a mobile-optimized web portal with PWA support and manual offline caching.
  • vouchervault combines vouchers, coupons, gift cards and loyalty cards in one application.
  • vouchervault tracks gift card transaction histories and supports item-specific image and PDF uploads.
  • vouchervault supports sharing items between users and displaying redeem codes as QR codes or barcodes.
  • vouchervault scans redeem codes through a camera or file upload and detects the code type automatically.
  • vouchervault sends expiry notifications through Apprise and supports OIDC single sign-on.

How l4rm4nd/vouchervault works

Users enter and manage digital items through the Django web portal. The myapp module provides the main application code, including the central request handling in myapp/views.py. The myproject module supplies the Django project configuration and settings. The docker directory provides container deployment files, including docker/docker-compose-sqlite.yml for the SQLite stack. Redis and Django-Celery-Beat process scheduled expiry checks, while Apprise sends notifications. The application can use SQLite3 or PostgreSQL and exposes a REST API with statistics for Home Assistant and other dashboards.

The codebase has 76 files and 1,365 symbols in 5 modules, led by Python, JavaScript and Dockerfile. Code health is 7.3 out of 10, rated good.

Getting started with vouchervault

  1. Create the persistent database directory.
    mkdir -p ./volume-data/database
  2. Adjust ownership of the persistent data.
    sudo chown -R 33:33 volume-data/*
  3. Start the SQLite container stack.
    docker compose -f docker/docker-compose-sqlite.yml up -d
  4. View the generated default password in the container logs.
    docker compose -f docker/docker-compose-sqlite.yml logs -f

Commands copied from the README

l4rm4nd/vouchervault FAQ

What is vouchervault?

vouchervault is a Django web application for storing and managing vouchers, coupons, loyalty cards and gift cards digitally. It includes a web portal with sharing, uploads, notifications and code scanning.

How does vouchervault work?

vouchervault uses Django to manage digital items through a web portal. Docker runs the application, Redis and Django-Celery-Beat handle scheduled expiry checks, and Apprise sends notifications.

How do I install vouchervault?

vouchervault runs with Docker Compose. Create the persistent directory, set its ownership, start docker/docker-compose-sqlite.yml, then read the generated password from the container logs.

What language is vouchervault written in?

vouchervault is primarily a Python and Django application, with JavaScript and HTML also used in the project.

How is the vouchervault code organized?

vouchervault places the main application code in myapp and Django project configuration in myproject. The docker directory contains container deployment files, and myapp/views.py is a central application file.

Who is vouchervault for?

vouchervault is for people who want to store and manage vouchers, coupons, loyalty cards and gift cards digitally. It supports multi-user access, sharing and OIDC single sign-on.

What license does vouchervault use?

vouchervault uses the GPL-3.0 license.

The summary, features and answers on this page are written by a model from the README and the source, and refreshed with each index.

About this page

Get a page like this for your own codebase

Repowise built this map of l4rm4nd/vouchervault from its source and git history. It parses every symbol, draws the dependency graph, scores each file's health from complexity, duplication, coverage and churn, finds hotspots and owners in the history, and writes documentation for every module. Your coding agent reads the same index over MCP, so its answers cite real files.

Index your repo freeSee how Repowise worksFree for 2 public repos, with a page like this one.

Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed.