# Sencha Touch Setup Guide

Topics:

- Introduction
- Installing Sencha Touch
- Sencha Touch Information

## Introduction

Sencha Touch, a high-performance HTML5 mobile application framework, is the cornerstone of the Sencha HTML5 platform. Built for enabling world-class user experiences, Sencha Touch is the only framework that enables developers to build powerful apps that work on iOS, Android, BlackBerry, Windows Phone, and Microsoft Surface.
Learn more at What's New.

## Installing Sencha Touch

To install Sencha Touch:

1. Download Java Runtime Environment version 1.7 (1.6 also works, but 1.7 is best). Sencha Cmd is written in Java and needs the JRE to run.
2. Download Sencha Cmd.
3. Download Ruby version 1.9.3 (Ruby version 2.0 doesn't work correctly with Sencha Cmd).
   - Windows: Download Ruby 1.9.3.n from rubyinstaller.org. Download the RubyInstaller .exe file and run it.
   - Mac OS: Ruby is pre-installed. You can test which version you have with the ruby -v command. If you have version 2.0, download the Ruby version manager (rvm) and use this command to download and install Ruby: rvm install 1.9.3 --with-gcc=clang
     Set your PATH variable to point to the Ruby 1.9.3 install directory.
   - Ubuntu: Use sudo apt-get install ruby1.9.3 to download and install Ruby 1.9.3.
4. If you are using Windows and running the IIS web server, add "application/x-json" as a MIME type for Sencha Touch to work properly. For information on adding this MIME type, see this Stackoverflow article.
5. For optimal debugging, use a modern web browser such as Chrome or Safari.
6. Create a project directory where you want to serve applications and ensure the directory is writable:
   Windows: Right-click the directory name, click Properties, and uncheck Read-only on the General tab.
   Mac or Ubuntu: Use chmod o+w <dir_name>
7. Copy the Sencha Touch unzipped directory to the directory where you are serving applications.
8. Start the Sencha Cmd web server to serve the applications directory:
   sencha fs web -port 8000 start -map <dir_name>
   (You can use any port number. The default is 1841.) You can access the Sencha Cmd web server using: http://localhost:8000/<dir_name>/<app_name>

Note If you need support for server-side scripting or PHP, you can get another web server such as XAMPP. If you use XAMPP, put the files you want to serve in the htdocs directory.

## Sencha Touch Information

- Sencha Documentation
- Sencha Touch Release Notes
- Sencha Touch Examples
- Sencha Touch Bundle
- Sencha Training
- Sencha Support
- Sencha.com