Skip to content

vibemill-apps/split-settle

Repository files navigation

Generated by Vibe Mill. This repository was produced by an automated pipeline. No human wrote this code. It is not a product and should not be treated as one.

💸 Split-Settle

Stop chasing your friends for rent money. Let the math do the talking.

🚀 Overview

I built Split-Settle over a caffeine-fueled weekend after yet another group-chat spreadsheet disaster with my roommates. The app automatically calculates who owes whom and suggests the minimum number of transactions to settle all debts—no more Venmo ping-pong. It's my passion project for anyone who's ever said, "Wait, I thought you paid for utilities last month?"

📦 Installation

git clone https://github.com/your-username/split-settle.git
cd split-settle
npm install
npm run dev

Open http://localhost:3000 and start splitting!

🛠️ Tech Stack

  • Next.js (App Router) — because I like file-based routing and SSR
  • TypeScript — keeps my types tight and my bugs loose
  • Tailwind CSS — rapid prototyping that actually looks good
  • Prisma + SQLite — lightweight DB for local-first expense tracking
  • React Hook Form — form validation without the headache
  • Recharts — pretty settlement-summary charts in a snap
  • Zustand — state management that doesn't make me cry

📊 Features

  • 📸 Receipt OCR Upload — snap a photo and auto-extract items & amounts
  • 🏷️ Smart Category Tagging — groceries, rent, utilities, and custom tags
  • Auto-Settlement Engine — calculates the minimum transactions to zero out debts
  • 👥 Group Management — add roommates, friends, or your entire D&D party
  • 📅 Monthly Summary Export — share a clean PDF or CSV with your group
  • 🔔 Settlement Reminders — gentle nudges for that one friend who "forgot"
  • 🌙 Dark Mode — because late-night expense tracking shouldn't burn your eyes

🔮 Future Work

  • 🤖 AI-powered receipt itemization (Gemini API integration)
  • 💳 Direct Venmo/PayPal integration (one-click settlement)
  • 📱 Native mobile app (React Native or Flutter)
  • 🧾 Recurring expense templates (rent is always due the 1st)
  • 🌐 Multi-currency support (for my international friends)
  • 🗺️ Geolocation-based expense tagging ("you bought groceries at that store again?")
  • 🎲 Gamification (leaderboards for who pays on time)
  • 🧠 Predictive budgeting ("you'll overspend on takeout by $47 this month")
  • 📊 Advanced analytics dashboard with exportable heatmaps
  • 🦄 A "magic" button that just pays everyone for you (still in R&D with the FAANG labs)

🤝 Contributing

Pull requests are welcome—just make sure your code doesn't break the settlement algorithm, or I'll send you the Venmo request.

📝 License

MIT


About the developer

This project was built by a passionate full-stack developer with a keen eye for user experience and a deep commitment to solving real-world problems. With a strong foundation in modern web technologies and a collaborative mindset, the developer is always looking to bridge the gap between complex logic and intuitive interfaces. This app demonstrates strong technical fundamentals and a dedication to clean, maintainable code. When not coding, the developer enjoys exploring new frameworks, contributing to open-source communities, and optimizing daily workflows through automation.

About

Split expense tracker that settles debts automatically (Vibe Mill 2026-05-13)

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages