This sample is a meant to be a starting point for any BlackBerry WebWorks developer creating an app that delivers the signature BlackBerry 10 experience, and could pass the "Built For BlackBerry" designation.

It includes many of the "must have" components: BBM, Share Framework, App Menu (swipe down), Window Covers, Toasts, BlackBerry 10 UI look and feel using bbUI.js.

If you'd like to learn more about the Built For BlackBerry program, be sure to head on over to the website.

Applies To

• BlackBerry 10 WebWorks SDK

Author(s)

• Chad Tetreault

Built For BlackBerry

• Visit the Built For BlackBerry program overview page.

Dependencies

1. bbUI.js is licensed under the Apache 2.0 license.

Icons

• The Liz Myers Icon set are licensed under the CC-BY-3.0 license.

Contributing

• To contribute code to this repository you must be signed up as an official contributor.

####Activity Spinner

Show

Spinner.on('small');
Spinner.on('medium');	
Spinner.on('large');	

Hide

Spinner.off();

####BBM####

Register with the BlackBerry Messenger service

Bbm.register();

Update users status message

Bbm.updateMessage();

Invite to download

Bbm.inviteToDownload();

####Invoking Apps####

Share Targets

Invoke.app.targets();

BlackBerry World - App

Invoke.app.blackberryWorld(applicationID);

Compose an email

Invoke.app.email('[email protected]', 'subject', 'body');

Maps

Invoke.app.maps('123 Street St, Waterloo, Ontario, Canada');

NFC

Invoke.app.nfc('http://www.blackberry.com');

Twitter

Invoke.app.twitter('this is a tweet!');

Facebook

Invoke.app.facebook('this is a status update!');

Take Photo

Invoke.utils.camera(function(path) {
	// success
		console.log('Photo: ' + path);
	},

	// card closed
	function(reason) {
		console.log('Card closed: ' + reason);
	},

	// error
	function(error) {
		console.log(error);
});

File Picker

Invoke.utils.filePicker(function(path) {
	// success
		console.log('Picked: ' + path);
	},

	// card closed
	function(reason) {
		console.log('Card closed: ' + reason);
	},

	// error
	function(error) {
		console.log(error);
});

####Toasts####

Regular

Toast.regular('This is a toast!', 2500);

With Button

Toast.withButton('Toast w/Button', 'Button', 'toastCallbackFunction', 3000);

####Window Covers####

Setup a Window Cover / Active Frame

App.ui.windowCover.setup('local:///cover.png');

1. Clone the repo to your local machine
2. Use Using the Ripple Mobile Emulator and the BlackBerry 10 WebWorks SDK, package the contents of your local BB10-WebWorks-Samples/Boilerplate-bbUI.js-0.9x folder into a BlackBerry application.

• BlackBerry HTML5 WebWorks - Downloads, Getting Started guides, samples, code signing keys.
• BlackBerry WebWorks Development Guides
• BlackBerry WebWorks Community Forums
• BlackBerry Open Source WebWorks Contributions Forums

Please see the README of the BB10-WebWorks-Samples repository for instructions on how to add new Samples or make modifications to existing Samples.

If you find a bug in a Sample, or have an enhancement request, simply file an Issue for the Sample.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.