Would you like to contribute to the Titanium docs? To get started, sign up for an account on the Appcelerator Wiki and sign our CLA.

Skip to end of metadata
Go to start of metadata

This page describes how to import a project into Studio.


You can import an existing set of files into Studio by creating a new project and pointing Studio to the home directory for your existing project.

Using the Import Wizard

To import an existing project into Studio, from menu bar, select File > Import to open the Import Wizard.

For a Titanium Classic or Alloy application:

  1. Select TitaniumExisting Mobile Project, then click Next.
  2. In the Project directory text field, browse to the folder that contains your project.
  3. You can optionally change the name of the project or copy the files to your current workspace.  If you do not copy the files, the project will remain in its directory but linked to the current workspace.
  4. Click Finish.

For a Github project:

  1. Select Git and either select:
    1. Fork Github Repository to fork and clone a Github repo.
    2. Git Repository as New Project to clone a Github repo.
  2. Enter your Github credentials, then click Validate.
  3. If you are forking a repo, enter the owner's name and repo name in the Owner and Repository Name fields, respectively.
  4. If you are not forking a repo, select the Github repo or enter the Git URI to the repo.
  5. In the Destination text field, enter a path to an empty folder to clone the repo.
  6. Click Finish.

For a Native Module, Node.ACS or other Web projects:

  1. Select GeneralExisting Folder as New Project, then click Next.
  2. In the Select folder text field, browse to the folder that contains your project.
  3. In the Project Name text field, enter a name your project.
  4. Choose the natures for your project.
  5. Click Finish.

Using Promote to Project

Promoting a folder to a project allow you to take any folder on disk and convert it into a project. You will see the project in your workspace, but the files live on disk in the former spot.

  1. Open the Project Explorer view.
  2. Expand the local filesystem node to the folder in question.
  3. Choose Promote to Project.
  4. Name your project appropriately and click OK.
  5. Depending on the type of project, you may need to change the "natures" associated with the project. See below.

Changing Project Type

You may also want to change the "type" of your project. See Changing Your Project Type