RoommateFinder

Description

Roommate Finder is a application built with MongoDB, Express, AngularJS and Node.js (MEAN stack). This web application recommends roommates to live with based on your preferences given.

Features

• Add preferences to User Profile.
• Search for Roommates based on filters.
• Show Search Results on Google Map.
• Have a toolbox on Map Points.
• Add registration for new user
• Handle Logout
• Add users management
• Add Like to search item
• Add recommendation model
• Improve recommendation based on likes.

Dependencies

The MEAN stack

• MongoDB as the database.
• Node.js as the server platform.
• AngularJS as the frontend framework.
• Express as the web framework.

Additional Tools

• Bower as package manager for web
• Bootstrap framework for developing responsive, mobile first projects on the web.
• Mongoose mongodb node.js driver in charge of providing elegant mongodb object modeling for node.js
• Passport an authentication middleware for Node.js which supports authentication using a username and password, Facebook, Twitter, and more.
• UI Bootstrap Bootstrap components written in pure AngularJS
• Nodemon Monitor for any changes in your node.js application and automatically restart the server

These are some of the advantages of a MEAN stack:

• Single language is used in the whole application
• Support for the MVC pattern
• JSON is used for transfering data
• Node.js's huge module library
• Open source so you can tweak it to your preferences if you're an experienced user

Installation

Make sure the above dependencies are install.

1. Run npm install.
2. Run bower install.
3. Launch mongod in one terminal then run app.js

mongod
nodemon appjs

4. Open browser http://localhost:1337/

Questions

For questions, contact Farhan Khwaja (fkhwaja@usc.edu)