🤖💸Splitr - AI Expense Splitting Platform

📌Overview

Splitr is a smart, AI-powered expense-splitting app built with Next.js, Tailwind CSS, Convex, and Clerk. It transforms the way groups manage shared costs by enabling real-time balance tracking, and intelligent suggestions — all enhanced by Gemini AI. Whether you're splitting bills or managing trip expenses, Splitr ensures fairness, and clarity.

📊 Project Insights

🌟 Stars	🍴 Forks	🐛 Issues	🔔 Open PRs	🔕 Closed PRs	🛠️ Languages	👥 Contributors

Features

• 💸 Add & Split Expenses – Quickly add expenses and split them evenly or unevenly among group members.
• 👥 Group Management – Create groups for trips, roommates, or events and manage shared bills effortlessly.
• 🔐 Secure Authentication – User sign-up and login powered by Clerk for a seamless and secure experience.
• ⚡ Real-time Sync – Powered by Convex, all updates reflect instantly across all users' devices.
• 🎨 Responsive UI – Clean and modern interface built with React.js, Tailwind CSS and Shadcn UI.
• 📊 Expense Summary – View clear, auto-updated balances for who owes whom.
• 🔄 Settle Up – Track settlements and reset group balances after payments.

🌟 Exciting News...

🚀 This project is now an official part of GirlScript Summer of Code – GSSoC'25! 💃🎉💻 We're thrilled to welcome contributors from all over India and beyond to collaborate, build, and grow Splitr! Let’s make learning and career development smarter – together! 🌟👨‍💻👩‍💻

👩‍💻 GSSoC is one of India’s largest 3-month-long open-source programs that encourages developers of all levels to contribute to real-world projects 🌍 while learning, collaborating, and growing together. 🌱

🌈 With mentorship, community support, and collaborative coding, it's the perfect platform for developers to:

• ✨ Improve their skills
• 🤝 Contribute to impactful projects
• 🏆 Get recognized for their work
• 📜 Receive certificates and swag!

🎉 I can’t wait to welcome new contributors from GSSoC 2025 to this Splitr project family! Let's build, learn, and grow together — one commit at a time. 🔥👨‍💻👩‍💻

🛠Tech Stack

• Frontend: Next.js, Javascript, Tailwind CSS, ShadCN UI
• Backend: Convex
• Authentication: Clerk
• Workflow Automation: Inngest
• AI Integration: Gemini AI

🏗 Local Development

Prerequisites

• Node.js ≥ 18
• npm or yarn
• Convex CLI npm install -g convex

🚀Demo

• Live Demo: Check out the live version of Splitr to see its features in action.

Getting Started

1. Clone the repository

git clone https://github.com/your-username/splitr.git
cd splitr

2. Install dependencies

npm install

3. Set up environment variables

Create a .env file in the root directory and add the required environment variables:

CONVEX_DEPLOYMENT=
NEXT_PUBLIC_CONVEX_URL=
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=
NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
CLERK_JWT_ISSUER_DOMAIN=
RESEND_API_KEY=
GEMINI_API_KEY=

Replace the values with your actual Clerk and Convex credentials.

4. Run the development server

npm run dev

Open http://localhost:3000 in your browser to see the app running.

🤝Contributing

We welcome contributions from the community! Please read our Contributing Guidelines before you start.

🌟Acknowledgments

• Clerk for authentication
• Convex for backend services
• ShadCN for UI components
• Tailwind CSS for styling
• Inngest for workflow automation

🤝 Contributing

We love contributions from the community! Whether it's a bug report, a new feature, or a documentation improvement, we appreciate your help.

How to Contribute

1. Fork the repository and create a new branch for your changes.
2. Make your changes and ensure everything is working as expected.
3. Submit a pull request with a clear description of your changes.

Found a Bug?

• Check the issue tracker to see if the bug has already been reported.
• If not, open a new issue and provide as much detail as possible.

Have a Feature Idea?

• We'd love to hear it! Open an issue to discuss your idea.

📜 Code of Conduct

Please refer to the Code of Conduct for details on contributing guidelines and community standards.

🤝👤 Contribution Guidelines

We love our contributors! If you'd like to help, please check out our CONTRIBUTE.md file for guidelines.

Thank you once again to all our contributors who has contributed to Splitr! Your efforts are truly appreciated. 💖👏

See the full list of contributors and their contributions on the GitHub Contributors Graph.

Show some by starring this awesome repository!

💡 Suggestions & Feedback

Feel free to open issues or discussions if you have any feedback, feature suggestions, or want to collaborate!

🙌 Show Your Support

If you find Splitr project helpful, give it a star! ⭐ to support more such educational initiatives:

• Giving the repo a ⭐ on GitHub
• Sharing it with your developer friends
• Contributing to the project

📄 License

This project is licensed under the MIT License - see the License file for details.

A short and simple permissive license with conditions only requiring preservation of copyright and license notices. Licensed works, modifications, and larger works may be distributed under different terms and without source code.

Permissions

• Commercial use
• Modification
• Distribution
• Private use

Limitations

• Liability
• Warranty

Conditions

• License and copyright notice

⭐ Stargazers

🍴 Forkers

🧑‍💻Project Admin:

Give us a Star and let's make magic!

👨‍💻 Built with ❤️ by Splitr Team

❤️ Dhruv Bajaj and Contributors ❤️

Open an Issue | Watch Demo

⬆️ Back to Top

Ready to show off your coding achievements? Get started with Splitr today! 🚀