shouse / corporate-directory

Corporate Directory App

Everyone needs to have quick and easy access to their business contacts. This corporate directory application showcases how you can easily build a high quality, cross platform application using the Appcelerator Mobile Platform.

Key App Features

master Branch

• A master / detail application using a customized ListView
• Searchable List
• ListViewSections created based on last name initial
• ListView Indexes (iOS only)
• Native Navigation Patterns using NavigationWindow for iOS and standard Windows for Android
• Includes native hooks to Maps, Email and Phone applications
• Loading data from local Filesystem

data-binding Branch

• Collection data binding to ListView
• Model / View binding on the Profile Page
• Uses Alloy Models to sync sample data to the SQLite database

Note: The data-binding branch does not create ListViewSections in the directory view.

Quick Start

• Open Appcelerator Studio and from the menu select File -> Import...
• In the Import dialog that opens, make sure the you expand the Git folder and select Git Repository as New Project
• Click the URI radio button option and paste URL of this repository into the text field
• Click Finish

Note: By default this project will be downloaded and cloned into your existing workspace

App Navigation

While the Directory app seems pretty full featured, its primarily a basic master / detail view application.

• MasterView => Directory Listing

  • View Contacts in Searchable List
  • Access Bookmarks
  • Quick Index Search - swipe left to reveal List Index (iOS Only)

• DetailView => Profile View

  • View Contact information
  • Add/Remove Contact as Bookmark
  • One Click to Email
  • One Click to Call

There is also one other view, for viewing your bookmarked contacts, but as you can see in the code we are actually re-using the same Directory Listing as the MasterView, and just filtering the contacts based on which ones are bookmarks. This is a great technique for when you need to show content, but simply need to filter by a particular property etc.

Bookmarks

To quickly access people that you contact more frequently, this Directory application allows you to easily bookmark a contact for quick reference later. Bookmarked contacts are denoted by a light blue ribbon.

You can access your bookmarked contacts at anytime by clicking on the book icon next to the search bar (on iOS) or in the action bar (on Android).

Adding a bookmark is easy, as the image below demonstrates.

Adding a Bookmark

1. Open the Directory app
2. Click on a contact that is not already bookmarked
3. On the Profile view, click on the Add to Bookmarks button
4. Click on the Directory back button to see your new bookmarked contact

Removing a Bookmark

1. Open the Directory app
2. Click on a contact that is bookmarked
3. On the Profile view, click on the Remove From Bookmarks button
4. Click on the Directory back button to see your new bookmarked contact

Get Help

There are a number of ways to get help with the Appcelerator Mobile Platform.

Official Documentation, Tutorials and Videos

Please visit the official documentation site at http://docs.appcelerator.com/ for the latest and historical documentation on Titanium, Alloy and the various products built by Appcelerator.

Developer Community

Appcelerator Developer is our developer community.

Video Tutorials

Appcelerator Videos is our main video channel for video tutorials on Titanium.

IRC

Titanium developers regularly visit #titanium_app on irc.freenode.net.

Twitter

Please consider following the @Appcelerator Twitter team for updates.

Blog

The Appcelerator corporate blog is called Think Mobile. The Appcelerator developer blog is located at (http://developer.appcelerator.com/blog).

Commercial Support, Licensing

We give our software away for FREE! In order to do that, we have programs for companies that require additional level of assistance through training or commercial support, need special licensing or want additional levels of capabilities. Please visit the Appcelerator Website for more information about Appcelerator or email [email protected].

Legal Stuff

Appcelerator is a registered trademark of Appcelerator, Inc. Titanium is a registered trademark of Appcelerator, Inc. Please see the LEGAL information about using our trademarks, privacy policy, terms of usage and other legal information at http://www.appcelerator.com/legal.