Nighttime Possum Meandering
    Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



    The Cameio Framework command line utility makes it easy to start, build, run, and emulate Cameio apps. In the future, it will also have support for our mobile development services and tools that make Cameio even more powerful.

    Use the cameio --help command for more detailed task information.


    $ npm install -g cameio

    Note: For a global install of -g cameio, OSX/Linux users may need to prefix the command with sudo.

    Starting an Cameio App

    $ cameio start myapp [template]

    Starter templates can either come from a named template, a Github repo, a Codepen, or a local directory. A starter template is what becomes the www directory within the Cordova project.

    Named template starters:

    Github Repo starters:

    Codepen URL starters:

    Local directory starters:

    • Relative or absolute path to a local directory

    Command-line flags/options:

    --appname, -a  .......  Human readable name for the app
                            (Use quotes around the name)
    --id, -i  ............  Package name set in the <widget id> config
                            ex: com.mycompany.myapp
    --no-cordova, -w  ....  Do not create an app targeted for Cordova

    Testing in a Browser

    Use cameio serve to start a local development server for app dev and testing. This is useful for both desktop browser testing, and to test within a device browser which is connected to the same network. Additionally, this command starts LiveReload which is used to monitor changes in the file system. As soon as you save a file the browser is refreshed automatically. View Using Sass if you would also like to have cameio serve watch the project's Sass files.

    $ cameio serve [options]

    Command-line flags/options:

    [--consolelogs|-c] ......  Print app console logs to Cameio CLI
    [--serverlogs|-s] .......  Print dev server logs to Cameio CLI
    [--port|-p] .............  Dev server HTTP port (8100 default)
    [--livereload-port|-i] ..  Live Reload port (35729 default)
    [--nobrowser|-b] ........  Disable launching a browser
    [--nolivereload|-r] .....  Do not start live reload

    Adding a platform target

    $ cameio platform ios android

    Building your app

    $ cameio build ios

    Live Reload App During Development (beta)

    The run or emulate command will deploy the app to the specified platform devices/emulators. You can also run live reload on the specified platform device by adding the --livereload option. The live reload functionality is similar to cameio serve, but instead of developing and debugging an app using a standard browser, the compiled hybrid app itself is watching for any changes to its files and reloading the app when needed. This reduces the requirement to constantly rebuild the app for small changes. However, any changes to plugins will still require a full rebuild. For live reload to work, the dev machine and device must be on the same local network, and the device must support web sockets.

    With live reload enabled, an app's console logs can also be printed to the terminal/command prompt by including the --consolelogs or -c option. Additionally, the development server's request logs can be printed out using --serverlogs or -s options.

    Command-line flags/options for run and emulate:

    [--livereload|-l] .......  Live Reload app dev files from the device (beta)
    [--consolelogs|-c] ......  Print app console logs to Cameio CLI (live reload req.)
    [--serverlogs|-s] .......  Print dev server logs to Cameio CLI (live reload req.)
    [--port|-p] .............  Dev server HTTP port (8100 default, live reload req.)
    [--livereload-port|-i] ..  Live Reload port (35729 default, live reload req.)

    While the server is running for live reload, you can use the following commands within the CLI:

    restart or r to restart the client app from the root
    goto or g and a url to have the app navigate to the given url
    consolelogs or c to enable/disable console log output
    serverlogs or s to enable/disable server log output
    quit or q to shutdown the server and exit

    Emulating your app

    Deploys the Cameio app on specified platform emulator. This is simply an alias for run --emulator.

    $ cameio emulate ios [options]

    Running your app

    Deploys the Cameio app on specified platform devices. If a device is not found it'll then deploy to an emulator/simulator.

    $ cameio run ios [options]

    Update Cameio lib

    Update Cameio library files, which are found in the www/lib/cameio directory. If bower is being used by the project, this command will automatically run bower update cameio, otherwise this command updates the local static files from Cameio's CDN.

    $ cameio lib update

    Packaging an app (beta)

    Using Cameio's service, you can compile and package your project into an app-store ready app without requiring native SDKs on your machine.

    $ cameio package debug android

    The third argument can be either debug or release, and the last argument can be either android or ios.

    Cordova Commands

    Cameio uses Cordova underneath, so you can also substitute Cordova commands to prepare/build/emulate/run, or to add additional plugins.

    Note: we occasionally send anonymous usage statistics to the Cameio team to make the tool better.

    Using Sass

    By default, starter projects are hooked up to Cameio's precompiled CSS file, which is found in the project's www/lib/cameio/css directory, and is linked to the app in the head of the root index.html file. However, Cameio projects can also be customized using Sass, which gives developers and designers "superpowers" in terms of creating and maintaining CSS. Below are two ways to setup Sass for your Cameio project (the cameio setup sass command simply does the manual steps for you). Once Sass has been setup for your Cameio project, then the cameio serve command will also watch for Sass changes.

    Setup Sass Automatically

    cameio setup sass

    Setup Sass Manually

    1. Run npm install from the working directory of an Cameio project. This will install gulp.js and a few handy tasks, such as gulp-sass and gulp-minify-css.
    2. Remove <link href="lib/cameio/css/cameio.css" rel="stylesheet"> from the <head> of the root index.html file.
    3. Remove <link href="css/style.css" rel="stylesheet"> from the <head> of the root index.html file.
    4. Add <link href="css/" rel="stylesheet"> to the <head> of the root index.html file.
    5. In the cameio.project file, add the JavaScript property "gulpStartupTasks": ["sass", "watch"] (this can also be customized to whatever gulp tasks you'd like).


    npm i cameio

    Downloadsweekly downloads









    last publish


    • avatar