Piglet

Piglet is a lightweight web application for managing household budgets and tracking expenses. It provides a simple web UI and a REST API for recording, categorizing and comparing expenditures across users and budgets.

Key Features

• Web-based dashboard for adding, categorizing and reviewing expenses
• REST API alongside the web UI for integrations and automation
• Multi-user support and budget sharing for families or groups
• Monthly reporting and basic analytics to track spending over time
• Docker image and docker-compose configuration for easy deployment
• Uses MariaDB as the primary persistent backend; environment variables control DB and mail settings
• Secure authentication with configurable cookie security (SECURE_COOKIE env var)

Use Cases

• Personal or household expense tracking and budgeting
• Shared family budgets with per-user expense categorization
• Lightweight backend for integrating expense data into other tools via the API

Limitations and Considerations

• Default configuration sets insecure cookies to allow HTTP by default; HTTPS and SECURE_COOKIE should be enabled for internet-facing instances
• Limited admin settings in the web UI (mail server and other admin controls are minimal or planned)
• UI has a few known visual issues (dark mode reload flashing, navigation behavior) and mobile styling is incomplete
• Feature set is intentionally simple — advanced accounting features, multi-language support, and password-change via UI are listed as roadmap items

Piglet is suited for users who want a simple, self-hosted budget manager with straightforward deployment via Docker and a small operational footprint. It prioritizes ease of use and privacy while remaining extensible via its API.