Set up a Titanium Workflow Without Studio

3 minute read

This article will talk about how to configure your environment to develop Titanium/Appcelerator apps withouth having to install another IDE (Appcelerator Titanium Studio). I personally use WebStorm and PHPStorm for development work and recently switched from a Eclipse based IDE, so why reinstall another Eclipse based IDE again.

To achieve this workflow we’re going to be using the Titanium-CLI to run all of our build/run commands straight from the command line instead of using a whole IDE to compile the app. I will also be focusing on Titanium 3.0.0+ since Appcelerator switched to a node.js build tool from Python, it’s a little easier to setup.

Installing Titanium CLI

Follow the instruction here to get the Titanium CLI installed.

Step 1: Install node.js

Step 2: You can install Titanium CLI locally or globally.

# To install globally
npm install titanium -g

# if you installed it this way, you should just be able to run:
# titanium
# To install locally
npm install titanium

# you can use the --save or --save-dev flags to save it to your package.json
# if you installed it this way, you will need to prefix all your commands like so:
# ./node_modules/.bin/titanium

Step 3: Sign in with the Titanium CLI

titanium login

It should automatically ask for you username/email and password. You need to create an account at Appcelerator.

Step 4: Install the latest sdk

The directions in the docs are a bit off here. It says that you should run the command: titanium sdk update --branch 3_0_X --default. But that doesn’t work quite right, this command only installs dev/nightly versions. Intead you can install the latest stable version of the SDK automatically with

titanium sdk install
# Or if you want a specific version
titanium sdk install <SDK_VERSION>.GA
titanium sdk install 3.5.0.GA

Create a new project

Step 1:

cd <some directory>

Step 2:

View the documentation for initializing a project here.

titanium create

Setting up the IDE (WebStorm)

Step 1:

Open the project with WebStorm

Step 2:

Generate the autocomplete/intellisense file for WebStorm to pick up. This can be done using the jsca2js project. This script generates a JSDoc annotated JS file from the SDK Docs JSON file on Appcelerator’s docs site.

Clone the repository somewhere

git clone [email protected]:navinpeiris/jsca2js.git
cd jsca2js

Run the script to generate the js file

./ <titanium-version>
./ 3.5.0

This generates a file: titanium-mobile-<titanium-version>.js. This file can be placed inside the project root directory and Webstorm should automatically pick up this file and index it.

Step 3: (optional)

If you choose not to put this file in your project root. It can be added as a global js library instead.

In WebStorm open: Settings > Languages & Frameworks > Libraries Here click the Add button. Name the library: Titanium Fill in version: <titanium-version> from earlier ex. 3.5.0 Click the + on the right and Attach Files... then look for the file that was generated earlier.

Set up a git pre-commit hook

If the project was set up with a git repository, let’s set up a pre-commit hook to validate our js files.

Install jshint and jscs globally (or locally)

npm install -g jscs jshint

Download the git pre-commit hook

curl > .git/hooks/pre-commit
chmod +x .git/hooks/pre-commit

Which downloads this file:

We can set up a file to exclude files with .precommitignore


Set up JSCS rules in .jscsrc. Rules can be viewed here.

Set up JSHint rules in .jshintrc. Rules can be viewed here. However, make sure this block is there

  "globals": {
    "Titanium": true,
    "Ti": true
  "predef": [

Set up Genymotion

Genymotion is a high speed android emulator that runs inside VirtualBox.

Step 1:

Create an account at

Step 2:

Download the installer at!/download if you don’t have VirtualBox, download the full installer. And then install it.

Step 3:

Start Genymotion. It should prompt to add a new device. Then add a new device with the device specs of your project.

Step 4:

Build & run the app in the android emulator with:

titanium build -p android

Leave a Comment