hujindo123/framework7-cli

Framework7 command line utility

Framework7 CLI

Framework7 command line utility makes easier to create Framework7 apps. Since Framework7 v4 release, CLI the most recommended way to start Framework7 app development.

Install

First of all make sure you have globally installed cordova (may require "sudo"):

$ npm install -g cordova

Then install framework7-cli (may require "sudo"):

$ npm install -g framework7-cli

Create Framework7 app

To create Framework7 app, run the following command in the directory where you want to create app:

$ framework7 create

Program will prompt for few questions about framework and template you want to start with.

Create Framework7 app with user interface

Run the following command in the directory where you want to create app:

$ framework7 create --ui

It will launch UI where you will be able to configure the project. By default it launches server on localhost:3001 address. If you want to change the port then use --port <n> argument:

$ framework7 create --ui --port 8080

Generate assets

In created project there is an assets-src directory. It contains required icons and splash screens source images. To generate your own icons and splash screen images, you will need to replace all assets in this directory with your own images (pay attention to image size and format), and run the following command in the project directory:

$ framework7 generate-assets

That is all, script will generate all required sizes of icons and splash screens and place them automatically where they need to be.

Generate assets with user interface

Run the following command in the directory with Framework7 project:

$ framework7 generate-assets --ui

It will launch UI where you will be able to change icons and splash screens. By default it launches server on localhost:3001 address. If you want to change the port then use --port <n> argument:

$ framework7 generate-assets --ui --port 8080

Cordova APIs

To run cordova related commands run the following command in the project root directory:

$ framework7 cordova [..args]

For example:

$ framework7 cordova plugin add cordova-plugin-statusbar
$ framework7 cordova plugin add cordova-plugin-splashscreen
$ framework7 cordova build ios
...