pebble/devsite/source/_posts/2016-12-22-pebblejs-package.md

title	author	tags
Pebble.js - Pebble Package Edition!	jonb	Freshly Baked

We're pleased to announce that Pebble.js has now been published as a {% guide_link pebble-packages "Pebble Package" %}. Pebble.js lets developers easily create Pebble applications using JavaScript by executing the JavaScript code within the mobile application on a user's phone, rather than on the watch.

Making Pebble.js a Pebble Package means Pebble.js projects can be converted to standard Pebble C projects. This gives benefits like the ability to easily utilize other Pebble Packages, such as Clay for Pebble, or easily importing and exporting the project with [CloudPebble]({{ site.links.cloudpebble }}).

The Pebble.js package is using the develop branch from the Pebble.js repository on Github, and can be updated independently from CloudPebble deployments.

It also supports the Diorite platform!.

Creating a New Project

The initial steps vary if you're using CloudPebble or the Local SDK. Follow the appropriate steps below to create a new project.

CloudPebble

If you're using CloudPebble, follow these initial steps:

1. Create a new project:

   • Project Type = Pebble C SDK
   • Template = Empty Project

2. Add the following dependency:

   • Package Name = pebblejs
   • Version = 1.0.0

3. Add a new main.c file and an index.js file.

Now continue to add the default project files.

Local SDK

If you're using the Local SDK, just create a new C project with Javascript support:

$ pebble new-project PROJECTNAME --javascript

Now continue to add the default project files.

Default Project Files

Copy and paste these default project files into your project, replacing any existing file contents:

your-main.c

#include <pebble.h>
#include "pebblejs/simply.h"

int main(void) {
  Simply *simply = simply_create();
  app_event_loop();
  simply_destroy(simply);
}

index.js

require('pebblejs');
var UI = require('pebblejs/ui');

var card = new UI.Card({
  title: 'Hello World',
  body: 'This is your first Pebble app!',
  scrollable: true
});

card.show();

At this point you should be able to compile and run your new project.

Migrating an Existing Project

Unfortunately there isn't an automated way to migrate your existing Pebble.js project, but the steps are fairly straightforward.

1. Create a new project, following the steps above.

2. Change the project settings to match your old project settings, including the UUID.

3. Copy your project resources (images, fonts etc.), and source files into the new project.

4. Compile and enjoy your new C project with Pebble.js support.

Note: index.js is a direct replacement for app.js, which may be your old Javascript file.

Next Steps?

Want to add Clay support to your project? It's now easy by following the standard Clay Getting Started instructions!

If you have any questions or problems, post the details on the developer forum or Discord.

Happy Holidays!

Jon Barlow + Team #PEBBLExFITBIT