I called the demo app “Foursquare Explorer”, it is built using Twitter Bootstrap, Web API, Foursquare API, and for sure AngularJS. I was amazed how fast I was able to produce functional and neat app.
Foursquare Explorer Web Application
At the beginning of the learning phase, I tried to read different articles and blog posts about Angular but I got lost and confused, until I watched this short 60 minutes tutorial done by Dan Wahlin, You won’t regret watching it if you are new to Angular.
Before discussing what we’ll build during this tutorial I would like to talk about some of the features and concepts of Angular:
AngularJS templating engine binds the data in two way, this means that it is auto-magically synchronize the data between the view and the model, so if you updated the view then the model is updated and vice verse. This feature will cut out lot of the code needed to update your DOM. You can check this out using this plunker live demo.
- Declarative v.s Imperative user interface:
Scopes in AngularJS can be considered the glue between the controller and the view, controller should not know anything about the view, and the view can know about the controller via the scope object.
Controller in AngularJS is function with two main responsibilities which they are implement business logic, and manipulating the scope, not the HTML DOM for sure.
Directives in AngularJS will let you teach HTML DOM elements what to do, you will be able to enhance the capabilities of DOM elements by creating your custom directives and promote code reuse.
Services in AngularJS are singleton objects, they are responsible for the heavy lifting in your app, most of the time they provide methods responsible to push/pull data from the back-end server or services. As well you can use services to share common logic between different controllers.
Filters will enable you to filter the data before it is projected to on the view, it might involve something straight forward such as date or numbers formatting, or you can implement your own custom filters such as filtering data source.
I feel you now, I believe you are confused with those new concepts! But do not worry, we’ll cover those concepts deeply during this tutorial while we are building the app.
What we’ll build in this tutorial?
I’m big fan of Foursquare, I’ve been always using their iPhone app for finding cool places with good rating; so I decided to build sample web application which allows us to explore places by providing your city i.e.(Amman) and optional category, then you will be able to bookmark places you like to visit them later!
Use cases we will cover in this web app are:
- Explore places based on City (Mandatory) and Places Category (Optional).
- Display 10 places on the view and enable server side pagination so we keep our app snappy.
- Displaying the top 9 image thumbnails of the place as a popover.
- Allow users to bookmark the place for future visit. (For the sake of simplicity we will use username without password and if you refreshed the page the user context is flushed).
- Displaying the bookmarked places for users.
- Finally we want cool UX and UI which will adopt to different screen sizes (Response Design) so we will use bootstrap UI as it plays nicely with AngularJS.
I’ve decided to breakdown this series to three posts, posts are:
Update (2014-May-5) New post which covers adding GulpJS as Task Runner for our AngualrJS application:
We’ll build this app incrementally so we will add feature by feature, the source code for this series is available on GitHub, feel free to download it locally or fork it, I’m open to ideas and suggestions to add more features to this app, Foursquare API is great and we can build many features on top of it. As well you can try a demo of the app.
If there is nothing clear or ambiguous please drop me a comment and I’ll do my best to reply your questions.
To get the best of this tutorial I recommend you to follow the posts one by one. Hope you’ll enjoy coding with AngularJS as much as I enjoyed