Meffin

Simple, lightweight monthly budget tracking

Built for simplicity and self-hosting

✨ Features

• 💰 Track income and expenses
• 🔄 Recurring transactions with flexible end dates
• 📊 Custom categories with colors
• 👥 Partner invites for budget collaboration
• 📱 Mobile-friendly PWA
• 🌍 Multi-language support (EN, FR)
• 🎨 Dark/Light theme
• 🏠 Self-hostable

🚀 Quick Start

git clone https://github.com/lucasnevespereira/meffin.git

cd meffin

cp .env.example .env.local

# Edit DATABASE_URL in .env.local (optional - uses Docker by default)
make dev

Open http://localhost:3000

🛠️ Commands

make dev      # Start development (auto-setup)
make migrate  # Generate migration after schema changes
make build    # Build for production
make clean    # Clean up and stop services

🏠 Self-hosting

Deploy anywhere that supports Node.js. Set your DATABASE_URL:

DATABASE_URL=postgresql://user:password@host:port/database

Works with Neon, Supabase, Railway, or self-hosted PostgreSQL.

🤝 Contributing

Contributions welcome! Fork the repo and submit a PR.

1. Fork & clone

git checkout -b feature/your-feature

2. Make changes & commit

git commit -m "feat: your feature"

3. Push & create PR

git push origin feature/your-feature

📄 License

This project is under MIT LICENSE