SplitMate

SplitMate is a modern mobile application designed to simplify the often tedious process of splitting bills and expenses among friends, roommates, or colleagues. Powered by AI-driven receipt scanning technology, the app allows users to effortlessly capture receipts using their phone's camera, automatically extracting item names, prices, and totals with high accuracy. Users can add their "mates" to the app and seamlessly assign individual items from a scanned receipt to the right people, eliminating the confusion and awkwardness that often comes with dividing shared expenses.

Project Structure

split-mate-mobile/
├── split-mate-app/     # React Native mobile application
│   ├── app/            # Expo Router pages
│   ├── src/            # Source code (components, services, etc.)
│   └── package.json
│
└── split-mate-api/     # Express.js backend API
    ├── config/         # Configuration
    ├── middleware/     # Express middleware
    ├── routes/         # API routes
    ├── services/       # Business logic
    └── package.json

Quick Start

Mobile App Setup

cd split-mate-app
npm install
npx expo start

See split-mate-app/README.md for detailed instructions.

Backend API Setup

cd split-mate-api
npm install
npm start

See split-mate-api/README.md for detailed instructions.

Development

Running Both Locally

Terminal 1 - Backend:

cd split-mate-api
npm start

Terminal 2 - Mobile App:

cd split-mate-app
npx expo start

Documentation

• Mobile App: See split-mate-app/
• Backend API: See split-mate-api/

Environment Variables

Each project has its own .env file:

• split-mate-app/.env - Mobile app configuration
• split-mate-api/.env - Backend API configuration

Copy the .env.example files in each folder to get started.