node package manager


Yeoman Generator - Cross Platform Web Launcher

This is a Yeoman generator that will build a cross platform web launcher (an icon that sits on the phone, which launches the system browser to a predefined URL) typically installed in the workspace, and based upon the BES10 Web-Launcher Sample app.



Before using this generator you must have your development environment(s) setup, and ready to roll for each platform you plan on building an app for. Refer to the Cordova Platform Guides which will walk you through the setup process.

Platform Setup Guides

Yeoman and Generator Installation

Yeoman is an NPM module, and installed globally through Node.js's npm command

  • Download and install Node.js
  • Install Yeoman: npm install -g yo
  • Install this generator: npm install -g generator-beslauncher

Running the Generator

To run the generator run the following from terminal / command-prompt

yo beslauncher

or, to list all installed generators and manually run it


The generator will prompt you for eight answers.

  1. Name - Displayed under the app icon.
  2. ID - Unique ID, typically in the com.companyname.appname format.
  3. Description - Short description of the app.
  4. Company Name - Your company name.
  5. Company Email - Contact email.
  6. Company Website - Website.
  7. URL - Where the app will 'launch' to.
  8. Platforms - Select all Platforms you want to build for. You must have the Platform environment already. setup

Next Steps

Next you need to build your new app. The --release flag indicates the app will be packaged for release.

*Note: For BlackBerry 10, you'll be prompted for your Signing Password. This is the password you chose when you Setup your Signing Keys.

cordova build --release


At this point you should have a fully customized, cross-platform web launcher. For more information on how to test and deploy this app on each platform refer to the Cordova Platform Guides.