AngularJS Phone Catalog Tutorial Application (Component-based)

This is a rewrite of the original phonecatApp tutorial app leveraging AngularAtom component-based organization structure. The 3 foundation blocks of the new organization are:

1. Components
2. UI states
3. UI layout(s)

Components

This app has one feature component called phone and one special component called utils where global feature-agnostic helper services are placed.

UI states

Implemented via AngularUI Router the UI has only 3 states with the top level one being abstract:

1. 'phones'         // abstract state, can't be transitioned to
2. 'phones.list'    // UI shows a list of all phones
3. 'phones.detail'  // UI shows detail info on the selected phone

         |phones| // <-- abstract state that loads default layout
           /  \
          /    \
         /      \
      |list|  |detail| // <-- concete states that plug in their own content into the default layout

UI layouts

The app has just one simple layout with no header, footer or any other UI container, besides just the main content area. We describe this layout in layouts/default.html and load it in the abstract phones UI state.

Directory structure

[app-name]/ # application root directory
  |__app/   # container for all user-generated app code
  |   |__components/   # stateless feature components
  |   |__layouts/      # layout specific partials
  |   |__states/       # application UI states
  |__bower_components/ # 3rd party vendor client libraries global to the entire app
  |__config/           # app related configuration
  |__node_modules/     # 3rd party vendor node.js modules global to the entire app
  |__scripts/          # shell scripts
  |__test-e2e/         # e2e tests

Usage

# Start application
$ npm start

# Run unit tests
$ npm test

# Run e2e (end-to-end) tests
$ npm run protractor

Acknowledgments

Thank you:

• @ilovecomputers for brainstorming emails and helping me with componentizing this app
• @inazarov for trying out AngularAtom component-based organization on a real app and providing valuable feedback.