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 AppceleratorExisting 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.

Note: if you are importing an older Alloy or Titanium application that was not created on the Appcelerator Platform, the import process will generate a new app GUID for the application and attempt to activate Appcelerator Platform services.


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, Arrow, 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 Drag and Drop

Starting with Studio 4.1.0, you can drag a project folder, previously created with either Eclipse or Studio, and drop it to the Project Explorer view to import the project to Studio and add it to your current workspace. Note that the files are not copied to the new workspace directory.  Studio only links to the project folder.

Import Error


 If you receive the error, "Invalid project, could not find .project file in the selected directory," the project was not created in Studio or Eclipse and does not contain a .project file, which tells Studio the nature of the project. Currently, only projects created in Studio or Eclipse support the drag-and-drop import process (TISTUD-7233). Projects created with the CLI cannot be imported using the drag-and-drop mechanism. Use the Import Wizard instead.



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