Build Your First App for webOS TV

Web apps for webOS TV are basically very similar to standard web apps. Further, they are given access to hardware and OS features typically available for native apps.
So if you have an experience in building web apps, you can start developing web apps for webOS TV easily, with your knowledge in standards-based web technologies, such as HTML, CSS, and JavaScript.

For information about using standard web API in developing a web app for webOS TV, see Standard Web API.


Here’s how you build your first app for webOS TV.

  1. Download and install CLI.

  2. Open webOS TV CLI and create a new app with the ares-generate command.

    ares-generate -t basic first-app

    You will use a template named basic, and your app will be created in the first_app directory.

  3.  Type in app id, title, and version.

    ? app id 
    ? title singlepane 
    ? version 0.0.1

    If you see Success, that means you have an app created in the first_app directory.

    Generating basic in C:\webOS_TV_SDK\CLI\bin\first-app
  4. Package the app in the first_app directory with the ares-package command. 

    ares-package first-app

    If packaging is successful, you can see the created .ipk file in the directory. 

  5. Run the webOS TV Emulator.

  6. Install the package file to the emulator with the ares-install command. Be sure to type correctly the file name of your package.

  7. Launch your app on the emulator with the area-launch command.


    If the app is successfully launched, you will see Hello World on the emulator.

You can test your app on the real TV using Developer Mode app. For how, see Using Developer Mode App.

Now you can either explore more about app development for webOS TV or start developing your own app for webOS TV!


Here's the list of recommended activities you can do next.

  • To learn about the lifecycle of an app, go to App Lifecycle. Understanding the app lifecycle will help you have a rough sketch on how your app will work.

  • To learn about JS services on webOS, go to JS Service Basics. JS services allow your app to do some work, even when it is not running.

  • To create a hosted web app, go to Hosted Web App. If you are planning on an app that requires continuous update, a hosted web app is a good choice.