You can create new projects easily from the projects dashboard. You will se a “card” with four options for creating projects:

Screen Shot 2015-12-31 at 10.31.50

Zip file

This is probably the option that you are going to use more. You just need to drop a zip file in the dotted area and it will start uploading and create an app when ready.

What should the zip file have inside?

When preparing your code you only need to zip the content of the folder where your index.html is. In the following project structure:

Screen Shot 2015-12-31 at 13.00.45

You should only zip the content of the 4053 folder, not the 4053 folder itself.

If you have a Cordova project structure in your local filesystem, you should only compress the contents of the www folder:

Screen Shot 2015-12-31 at 13.07.22

So basically make sure that in the root if your zip file there is always a index.html file to run.

What is the maximum size of the zip file?

The file size of the zip file that you can upload to the cloud may vary between plans. Take a look at the pricing plans to see what’s the corresponding size limit for your plan and what can you get upgrading to another plan.

From Web2App

This option is aimed at people that want to create a native application using an existing website that is already hosted in a server accessible in the Internet. Web2App does not convert your application in a responsive webapp so keep in mind that your website must be responsible for it to show properly in the mobile device.

The process is easy, just provide the url pointing to your website (ie. http://cocoon.io) and click on create and your application will be created with a working configuration and a bundle id based on your website url.

Screen Shot 2015-12-31 at 10.35.38

 

This project creation mode will add by default the following configurations to your project:

  • The webview engine will be set to Webview+. As this is the fastest and more up to date environment for full DOM websites we set this as the webview engine by default.
  • We set the bundle id as your reverse domain.
  • We set the project name as your url domain.

Probably some of this configurations don’t fit your needs but remember that you can change them later in the project configuration options.

From Github

Another option is to create your application from a Github repository. The repository must be public, we don’t support private repositories yet. To create your app you just need to provide the Github repository url. To be a valid Github url it must end with the .git extension otherwise it won’t be recognized as a valid Github url.

Screen Shot 2015-12-31 at 10.38.39

And your application is ready to be compiled. Maybe you need to make some more customizations like your own bundle id, name, orientation, etc. Take a look at the project configuration article to know more on this.

Guided creation

We provide a special option for those who want to start with an already configured project. When you click on guided creation you’ll see some demos to choose among. You can read the description below the chooser to know more about the demo.

Screen Shot 2015-12-31 at 10.46.33

Select one of the demos and click on “next”.

In the second screen you can select the webview engine that you want to use in your development. You can read more about the webviews and their differences here.

Once you have chosen your webview you just need to configure the main application parameters and create the application.

Screen Shot 2015-12-31 at 10.47.36