pablobastidasv/housefy repository overview

⁠Housefy - Family Budget Management

Personal finance app for tracking budgets, transactions, and spending analysis.

⁠Quick Start

docker pull pablobastidasv/housefy:latest
docker-compose -f docker-compose.prod.yml up -d

⁠Features

✅ Budget tracking with category-based organisation
✅ Mobile-responsive design
✅ Secure session-based authentication
✅ Single-container deployment with auto-migrations
✅ Multi-architecture support (amd64/arm64)

⁠Tech Stack

• Go 1.26 • MariaDB 11 • HTMX 2.0 • TailwindCSS • Alpine Linux

⁠Environment Variables

• DB_HOST - Database host (default: db)
• DB_USER - Database user (default: budgets_user)
• DB_PASSWORD - Database password (required)
• DB_NAME - Database name (default: budgets)
• PORT - App port (default: 8080)

⁠Tags

• latest - Latest stable release
• vX.Y.Z - Semantic versions
• X.Y / X - Major/minor versions

⁠Health Check

http://localhost:8080/health⁠

⁠Documentation

Full Docs (https://github.com/pablobastidasv/budgets⁠)