Splitzy 💸

Real-time expense tracking with AI-powered insights — fast, beautiful, modern.

---

🚀 Overview

Splitzy is a modern, full-stack expense management platform designed for groups, friends, roommates, and trips.
Track shared expenses, split costs fairly, and understand settlements with AI-powered explanations.

Featuring real-time sync, clean UI, background workflows, and instant clarity for who owes what.

---

✨ Features

🔥 Core Functionality

• Add shared expenses with equal or custom splits
• Automatic balance calculation
• Real-time updates using Convex
• Clean dashboards for groups, totals, and settlements

🤖 AI-Powered Insights

• GPT-powered breakdowns of balances
• Human-friendly settlement suggestions
• Monthly or per-trip expense summaries
• Automatic categorization (configurable)

🎨 Beautiful UI/UX

• Built using shadcn/ui + Tailwind
• Smooth animations
• Dark mode ready
• Mobile-first responsive design

🔐 Secure Authentication

• User accounts managed by Clerk
• Protected dashboards and groups

🧵 Background Workflows with Inngest

• AI summaries run asynchronously
• Ready for reminders / digest reports
• More workflow automation possible

---

🧰 Tech Stack

Layer	Technology
Frontend	Next.js (App Router), JavaScript, Tailwind CSS, Shadcn/ui
Backend	Convex → database + server functions
Auth	Clerk
AI	OpenAI / any LLM provider
Workflows	Inngest
Styling	Tailwind CSS + custom design system

---

📸 Screenshots (Add later)

Dashboard — balances & groups

---

🛠️ Getting Started

1️⃣ Clone the project

git clone https://github.com/Syl3r27/Splitzy.git
cd splitzy
2️⃣ Install dependencies
bash
Copy code
pnpm install
3️⃣ Configure environment variables
Create a .env.local:

env
Copy code
# Clerk
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=
NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up

# Convex
NEXT_PUBLIC_CONVEX_URL=
CONVEX_DEPLOY_KEY=
CONVEX_ADMIN_KEY=

# Inngest
INNGEST_EVENT_KEY=

# AI Provider
OPENAI_API_KEY=
4️⃣ Start Convex
bash
Copy code
npx convex dev
5️⃣ Run the development server
bash
Copy code
pnpm dev
Now open → http://localhost:3000


🗺️ Roadmap
 Add expense export / shareable links

 Add notifications & reminders via Inngest

 More AI analytics (categories, anomalies)

 Multi-currency support

 PWA for offline mobile use

 Group chat for notes & context

🤝 Contributing
Pull requests and issues are welcome!
Feel free to discuss ideas or propose new features.

📝 License
Licensed under the MIT License.

⭐ Support
If you like Splitzy, please ⭐ star the repo — it helps a lot!