Skip to content

AdityaP700/split-mate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

80 Commits
 
 
 
 
 
 
 
 

Repository files navigation

SplitMate

SplitMate Logo

The Future of Bill Splitting

A modern, blockchain-powered expense sharing app with real-time chat integration and AI-powered insights

License: MIT Next.js TypeScript Base XMTP

Live Demo🐛 Report Bug Request Feature


What is SplitMate?

SplitMate revolutionizes how groups handle shared expenses by combining the power of blockchain technology, real-time messaging, and AI intelligence into one seamless experience. Say goodbye to awkward payment requests and hello to instant, transparent, and secure bill splitting.

Perfect for: Friend groups, roommates, team lunches, travel expenses, event planning, and any scenario where money needs to be split fairly and quickly.


Key Features

Feature Description
Real-time Group Chat Built on XMTP protocol for decentralized, secure messaging
Instant Crypto Payments Lightning-fast transactions on Base L2 blockchain
Secure Wallet Auth Coinbase Wallet integration for enterprise-grade security
AI-Powered Analysis Smart context interpretation and automatic split suggestions
Equal Bill Splitting Automatic fair distribution among all participants
Live Database Sync Real-time data synchronization across all devices
QR Code Payments Scan-and-pay functionality for ultimate convenience
Modern UI/UX Clean, intuitive interface built with Tailwind CSS

Demo & Screenshots

Video Demo

Coming Soon: Watch SplitMate in action

SplitMate Demo

Click to watch the full demo (3 minutes)

Desktop Experience

dashboard-layout.mp4

Full desktop experience with multi-panel layout


Tech Stack

Frontend

Next.js TypeScript Tailwind CSS React

Blockchain & Web3

Ethereum Web3

Communication

XMTP

Category Technology Purpose
Frontend Next.js 13+ React framework with SSR/CSR hybrid
Language TypeScript Type-safe development environment
Styling Tailwind CSS Utility-first CSS framework
Messaging XMTP Protocol Decentralized real-time communication
Blockchain Base L2 Fast, low-cost Ethereum scaling solution
Wallet Coinbase Wallet SDK Secure authentication and transactions
Web3 Ethers.js Ethereum library for blockchain interaction
AI Custom AI Engine Context analysis and smart suggestions

Quick Start

Prerequisites

  • Node.js 18+ and npm/yarn
  • A Coinbase Wallet
  • Basic understanding of Web3 concepts

1️⃣ Clone & Install

# Clone the repository
git clone https://github.com/your-username/split-mate.git
cd splitmate

# Install dependencies
npm install
# or
yarn install

2️⃣ Environment Setup

Create a .env.local file in the root directory:

# Application Settings
NODE_ENV=development
NEXT_RUNTIME="nodejs"
NEXT_PUBLIC_DEV_MODE=true

# Wallet Configuration
NEXT_PUBLIC_WALLET_CONNECT_PROJECT_ID=your_project_id_here

# Blockchain Configuration
NEXT_PUBLIC_BASE_GOERLI_RPC_URL=https://goerli.base.org
NEXT_PUBLIC_BASE_MAINNET_RPC_URL=https://mainnet.base.org

# XMTP Configuration
NEXT_PUBLIC_XMTP_ENV=production
NEXT_PUBLIC_XMTP_API_KEY=your_xmtp_api_key_here

# Optional: Development Settings
NEXT_DEV_HTTPS=true
NEXT_TELEMETRY_DISABLED=1
NEXT_DISABLE_SENTRY=true

3️⃣ Run Development Server

npm run dev
# or
yarn dev

Open http://localhost:3000 to see SplitMate in action!


Step-by-Step Process

  1. Secure Connection - Users connect their Coinbase Wallet for authentication
  2. Real-time Chat - Join group conversations via XMTP's decentralized protocol
  3. Bill Input - Enter the total amount to be split among participants
  4. AI Magic - Our AI analyzes context and suggests optimal split strategies
  5. Fair Division - Automatic equal splitting with precision calculations
  6. Instant Payments - Lightning-fast crypto transactions on Base L2
  7. Live Updates - Real-time confirmation and receipt generation

Use Cases

Dinner with Friends

"4 friends, ₹4000 bill, split equally in seconds with crypto payments"

Roommate Expenses

"Monthly utilities, groceries, and shared costs managed transparently"

Group Travel

"Hotels, flights, and activities split fairly among travel companions"

Event Planning

"Party supplies, venue costs, and catering shared among organizers"

Team Lunches

"Office meals and team building expenses handled professionally"


🤝 Contributing

We ❤️ contributions! SplitMate is built by the community, for the community.

🌟 Ways to Contribute

  • 🐛 Bug Reports - Help us squash bugs
  • Feature Requests - Share your brilliant ideas
  • Documentation - Improve our docs
  • Code Contributions - Add new features or fix issues
  • Design - Enhance UI/UX and user experience
  • Testing - Help us ensure quality

🚀 Quick Contribution Guide

# 1. Fork the repository on GitHub

# 2. Clone your fork
git clone https://github.com/YOUR_USERNAME/split-mate.git

# 3. Create a feature branch
git checkout -b feature/amazing-new-feature

# 4. Make your changes and commit
git commit -m "✨ Add amazing new feature"

# 5. Push to your branch
git push origin feature/amazing-new-feature

# 6. Open a Pull Request

📋 Development Guidelines


🏆 Core Team

Aditya Pattanayak
Aditya Pattanayak

🛠️ Full Stack Developer
XMTP • Database • Architecture
💼 🐦
Vidip Ghosh
Vidip Ghosh

🎨 Full Stack Developer
Frontend • Web3 • Wallet Integration
💼 🐦

📊 Project Stats

GitHub stars GitHub forks GitHub issues GitHub pull requests

GitHub top language GitHub code size GitHub last commit


🗺️ Roadmap

🚀 Phase 1: Core Features (Completed)

  • Wallet authentication
  • XMTP integration
  • Equal bill splitting
  • Base blockchain payments

🎯 Phase 2: Enhanced Features (In Progress)

  • 🎨 Custom split ratios
  • 📊 Expense analytics dashboard
  • 🔔 Push notifications
  • 📱 Mobile app (React Native)

🌟 Phase 3: Advanced Features (Planned)

  • 🤖 Advanced AI suggestions
  • 🌍 Multi-chain support
  • 👥 Group management tools
  • 📈 Spending insights & reports

🚀 Phase 4: Scale & Growth (Future)

  • 🏢 Enterprise features
  • 🔗 API for third-party integrations
  • 🌐 Multi-language support
  • 🎯 Advanced privacy features

🐛 Issues & Bugs

Found a bug? Please check our issue tracker and create a new issue if it doesn't exist.


📄 License

SplitMate is open source software licensed under the MIT License.

MIT License - feel free to use this project for any purposes!

🙏 Acknowledgments

Special thanks to:

  • XMTP Team - For building the decentralized messaging protocol
  • Base Team - For providing fast, affordable blockchain infrastructure
  • Coinbase - For the excellent wallet SDK and developer tools
  • Tailwind CSS - For the amazing utility-first CSS framework
  • Next.js Team - For the powerful React framework
  • Open Source Community - For inspiration and continuous support

🚀 Ready to revolutionize bill splitting?

⭐ Star this repo🍴 Fork it


Built with ❤️ by the SplitMate team

SplitMate - Building the future of expense sharing — fast, secure, and intelligent.