lycanthrope8 / expensesplittr

ExpenseSplitte

Welcome to ExpenseSplitte, the ultimate web service for making shared living hassle-free! Designed with bachelors in mind, ExpenseSplitte helps you easily find nearby homes, track shared expenses, and keep everything organized. Say goodbye to awkward money conversations and hello to a smoother, more transparent living experience!

🌟 Features

• 🏠 Find Nearby Homes: Discover available homes in your area and join a shared living space.
• 💰 Expense Tracking: Effortlessly track all shared expenses and manage repayments.
• 🔄 Debt Management: Instantly see who owes whom money and keep finances clear and fair.
• 💬 In-App Chat: Communicate seamlessly with your housemates using our built-in chat feature. (Note: The chat system design is still a work in progress and will be improved in future updates.)
• 📝 Home To-Do List: Organize and manage household tasks with a shared to-do list.

🚀 Getting Started

Getting started with ExpenseSplitte is easy and quick:

1. Sign Up: Create your account to get started.
2. Find a Home: Search for available homes and join the one that suits you.
3. Manage Expenses: Add and track shared expenses, and see who owes whom.
4. Communicate: Use the chat feature to stay connected with your housemates.
5. Organize Tasks: Use the home to-do list to keep track of household chores.

⚙️ Installation

Want to run ExpenseSplitte locally? Follow these steps:

Prerequisites

• Node.js
• npm or yarn
• MongoDB (for the backend)

Backend Setup

1. Navigate to the backend directory:

   cd backend

2. Install dependencies forcefully:

   npm install --force

3. Start the backend server:

   npm start

Frontend Setup

1. Navigate to the frontend directory:

   cd frontend

2. Install dependencies forcefully:

   npm install --force

3. Start the frontend development server:

   npm start

Run the Full Application

Ensure both the backend and frontend servers are running concurrently to experience the full functionality of ExpenseSplitte.

🤝 Contributing

We'd love your help in making ExpenseSplitte even better! Check out our contributing guidelines to get started.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

📧 Contact

Got questions or suggestions? Drop us a line at [email protected].

---

Enjoy a simpler, more organized shared living experience with ExpenseSplitte! 🌟