See the Project Pitch on this presentation

This is an app to help newcomers in Munich find a flat.

This app will allow users to search for appartment listings for various areas in Munich. They will also see information about each area. In the FAQ section, they will be able to see tips to find a flat and what to do next.

This app uses a 'fake' API from ImmobilienScout24 and Google Maps to show listings in Munich. The site is styled with Bootstrap, the pictures come from Pixabay, with a creative common 0 license.

-General Features

• A responsive website for mobile, tablet and desktop.

• Flat Search

  • Show a list of search results for flats Note
  • Show results according to each area
  • Show other relevant data for each area.

• FAQ

  • A bootstrap accordeon to present Q&A

• Contact Form

  • Validate the form

• Flat Search:
  • Use the real API from Immoscout

• AngularJS
  • We use AngularJS to handle page routing, we also use it to make calls to the REST API and build custom directives
• Bootstrap
  • We use Bootstrap to give our project a simple, responsive layout
• npm
  • We use npm to help manage some of the dependencies in our application
• bower
  • Bower is used to manage the installation of our libraries and frameworks

All the tests can be found on this document.

1. Firstly you will need to clone this repository by running the git clone https://github.com/mathilde206/MunichFlatFinder.git command
2. After you've that you'll need to make sure that you have npm and bower installed
3. You can get npm by installing Node from here
4. Once you've done this you'll need to run the following command: npm install -g bower # this may require sudo on Mac/Linux
5. Once npm and bower are installed, you'll need to install all of the dependencies in package.json and bower.json

npm install

bower install

4. After those dependencies have been installed you'll need to make sure that you have http-server installed. You can install this by running the following: npm install -g http-server # this also may require sudo on Mac/Linux
5. Once http-server is installed run http-server -c-1
6. The project will now run on localhost
7. Make changes to the code and if you think it belongs in here then just submit a pull request

If you would like to contribute to the content (extra tips about Munich, correct a wront information), feel free to get in touch with me.