View source for Gaia/Notifications

= Background =

== Status ==

* Stage: Development
* Latest: Fabrice has implemented necessary API. Etienne is going to implement in Gaia. (March 23, 2012)
* Release target: [https://wiki.mozilla.org/B2G/Schedule_Roadmap#Milestone_3_.5BAlpha.5D B2G Milestone 3 [Alpha]], Q2 2012

== Team ==

* UX: Josh Carpenter (IRC: jcarpenter)
* UX: Casey Yee (IRC: cyee)
* Dev: Etienne (IRC: etienne_s)
* Eng: Fabrice (IRC: fabrice)
* Eng: Chris Jones (IRC: cjones) 
* Eng: Mounir Lamouri (IRC: mounir)
* Eng: Jonas Sicking (IRC: sicking)

== Reading ==

* [http://groups.google.com/group/mozilla.dev.b2g/browse_thread/thread/4b24744a9eabc3eb# dev-b2g "Notifications in B2G"]
* [http://groups.google.com/group/mozilla.dev.webapi/browse_thread/thread/db29059c5c8e2527# dev-b2g "Homescreen 'embedding' api]


= Use Cases =

=== General ===
* User receives a push notification (eg: new email).
* User receives a phone call.
* User receives a phone call, but misses it.
* User receives a permission request from a website (eg: for location tracking).
* User receives a permission request from an installed app.
* User receives a notification while the device is locked.
* User wants to review recent notifications.

=== Conflict ===
* User receives a push notification (eg: SMS) while on a phone call.
* User is in a browser, deciding whether to grant a location tracking permission request for a website, when she receives an incoming call notification.


= Requirements =

==== P1 ====
* Notifications can be prioritized (eg: incoming call notification takes precedence over all other device activities)
* Notifications can be grouped by:
** App
** Time
** Priority
* Notifications can be displayed in one of several UI formats (listed in order of disruption):
** Status bar
** Passive
** Alert
** Full screen
* If the user switches to another application, indication that the user is still on the call and whether they are muted or not should be indicated in the status bar (potential through icon indicator or colour change on the status bar)

==== P2 ====
* User can configure notification methods on a per-app basis (eg: can toggle between passive or alert SMS notifications).
* Time stamps can be relative (eg: "13 minutes ago" instead of "2:45 PM")
* Notifications can include vibration or audio.

=Design Spec=
Interaction Design Spec (Draft): https://www.dropbox.com/s/x3u1b47xn6r8amz/Notifications.pdf