A command line tool to create, build and serve Tabris.js apps.
npm install -g tabris-cli
Creates a new Tabris.js app in the current directory.
tabris serve [options]
Starts a server the Tabris.js developer app can be pointed to. If a build script is present in package.json, it is executed beforehand.
-p [path], --project [path]
The directory to serve the Tabris.js app from. Needs to contain a package.json and installed “tabris” module. When omitted, the current working directory is served.
-m [module], --main [module]
Overrides the “main” field of package.json. The argument must be a valid module id relative to the project root, e.g. “dist/main.js”.
Auto reload the application when a source file is modified.
Logs requests to the internal HTTP server of the CLI. Useful for debugging connection issues during app sideloading.
Executes the watch instead of the build script given in the package.json of the app before serving. The watch script can be a long-running task.
Does not print the available external URLs or QR code to the console, only the port. They can still be viewed by opening the given port in a browser.
Uses the given string as the advertised public URL, to the exclusion of all other. Must include protocol and port. Should be used with
--port to ensure the actual port matches this one.
Changes the port the HTTP server listens to. Causes an error if the port is not available.
tabris build [options] <platform> [cordova-platform-opts]
Builds a Tabris.js app for the given platform.
To speed up the build, pre-compiled build artifacts are kept in a build cache and are reused in subsequent builds. To clean up the build cache, e.g. after updating Cordova plug-ins, run
tabris run [options] <platform> [cordova-platform-opts]
Builds a Tabris.js app and runs it on a connected device or emulator.
The ID of the target device to deploy the app to. See
Show a list of available targets to use with
Removes build artifacts.
tabris run and
tabris build parameters
Note: when neither
--device is specified and a device is connected, the app will be built for a device. If no device is connected, the app will be built for an emulator.
Comma-separated list of variable replacements in config.xml.
--variables FOO=bar,BAK=baz will replace all occurrences of
$BAK in config.xml with respectively
Note: per default all environment variables are replaced in config.xml. To prevent that, use the
Path to a build configuration file passed to Cordova. Relative to the
You may want to include this file in
.gitignore since it may contain sensitive information.
Perform a debug build. Used for development.
Perform a release build. Used when building apps for the marketplace of their platform.
Build the app for an emulator.
Build the app for a device.
Do not replace environment variables in config.xml.
--variables documentation for more information about variable replacement in config.xml.
Print more verbose output.
Platform-specific options passed to Cordova.