You can create new projects easily from the projects dashboard. You will se a “card” with four options for creating projects:
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:
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:
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.
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.
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.
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.
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.
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.
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.