NativeScript · tjvantoll · Oct 17, 2014 · Oct 17, 2014 · Nov 19, 2014 · Nov 19, 2014
diff --git a/cli.md b/cli.md
@@ -0,0 +1,76 @@
+---
+nav-title: "NativeScript CLI"
+title: "CLI"
+description: "NativeScript Documentation: Command-line Interface"
+position: 16
+---
+
+# Command-line Interface
+
+Using a command line interface (CLI) is a very productive and simple way to use a developer framework. With the NativeScript CLI, it is possible to IDE to edit the application code and use the CLI to build and deploy the application to an emulator or on a real device.
+
+One of the goals with NativeScript is having tools that are very similar to existing ones to lower the learning curve. If you are familiar with the [Cordova Command-line interface (Cordova CLI)](http://cordova.apache.org/docs/en/3.6.0/guide_cli_index.md.html), you're ready to build your cross-platform application with the NativeScript CLI.
+
+#Prerequisites
+
+It is important to note that NativeScript is all about building applications for devices. Thus, to test and run our product, we need the respective Software Development Kits (SDKs) and build tools installed in accordance to their license terms. For example, on a MAC computer one can install Node.js, Xcode, Java, Android SDK and Apache Ant and then test their NativeScript project on both an iOS simulator and device(s) and Android emulator and device(s). On the other hand, there is no Xcode for Windows PC, hence only Android applications can be tested there, provided we have Java, the Android SDK and Apache Ant. The full requirements can be found in the [System Requirements section of the official NativeScript package readme file](https://www.npmjs.org/package/nativescript#system-requirements).
+
+#Installing the NativeScript CLI
+
+The [NativeScript CLI](https://www.npmjs.org/package/nativescript) is distributed as a Node.js NPM package. Thus, its installation is as simple as installing any other NPM package. It is recommended that you install it globally so that you can access it from any folder.
+
+The command `npm install -g nativescript` will add the `nativescript` (or its synonym, `tns`, used further for shortness) program available to your console.
+
+#Creating a project using the default template
+
+Navigate to a preferred 'projects' folder of yours and type `tns create HelloWorld`
+
+![tns create *nix](img/cli/tns-create-unix.png "tns create *nix")
+![tns create windows](img/cli/tns-create-windows.png "tns create windows")
+
+A new folder will get created, named `HelloWorld`. It contains some sample code, available at [github](https://github.com/NativeScript/template-hello-world).
+
+![finder app created](img/cli/finder-app-created.png "finder app created")
+If you check the folder in Finder or Windows Explorer, you will notice it contains two folders: `app` and `platforms`.
+
+The latter is empty at this stage of the app creation. Once we start "enabling" our project with specific platforms (iOS and Android supported for the time being), the `platforms` folder will contain platform-specific versions of our project. Please note that this folder is automatically re-generated based on the cross-platform code changes, so please do not alter its content, because it will be replaced next time the app is build. Use this folder for debugging purposes only.
+
+The app folder contains the actual cross-platform code, the resources of our application and some pre-packed JavaScript modules, representing the NativeScript framework. The most important content in it are the:
+
+- `app` subfolder, which is our application code. Generally, any edits of the application logic go here. Please, check [the documentation](https://github.com/nativescript/docs) for the available APIs (cross-platform, android and iOS).
+
+- `App_Resources` subfolder, which contains some platform-specific resources. The structure and the usage of resources is still to be finalized, hence for the time being do not delete, move or rename any files from that folder. Modification of the images to fit your brand is perfectly fine.
+
+- `tns_modules` subfolder, containing cross-platform modules, pre-packed by Telerik. In the future, the CLI will allow modules to be added/updated via a special command in a plugin manner.
+
+#"Enabling" the project to a specific platform
+
+To run the already created project on an emulator or a physical device, first navigate to the project-folder you just created (i.e. `cd HelloWorld`).
+
+On a mac/windows/linux computer, type the command `tns platform add android`. Alternatively, on a mac computer type the command `tns platform add ios`.
+
+![tns platform add ios *nix](img/cli/tns-platform-add-ios-unix.png "tns platform add ios *nix")
+![tns platform add android windows](img/cli/tns-platform-add-android-windows.png "tns platform add android windows")
+
+These will download the android or ios runtimes for NativeScript and will unfold them using the contained platform-specific project to the `platforms` folder. A runtime package contains a platform-specific (Eclipse for Android or XCode for iOS) template project and a set of binaries, allowing the NativeScript javascript code to be executed on the target device.
+
+#Populating the cross-platform code to platform-specific folders
+
+The next step is running the command `tns prepare android` (alternatively, `tns prepare ios`).
+
+In essence, this command copies the files in the `app/app`, `app/App_Resources` and `app/tns_modules` folders to the `platforms/[SpecifiedPlatform]` folder, following some logic.
+
+![tns prepare android windows](img/cli/tns-prepare-android-windows.png "tns prepare android windows")
+
+The `prepare` command is not run automatically during an `emulate` command call on purpose. The reason is that while debugging we might change the javascript in the platform-specific project (under the `platforms` folder) and we want to debug that code directly by running the emulate or run commands. If the prepare command was called, it would overwrite our changes.
+
+#Running the application
+
+- `tns emulate ios` - call this command on a Mac computer to get your project deployed and started on the iOS simulator
+- `tns emulate android` - call this command on a Mac/Windows/Linux computer to get your project deployed and started on the Android emulator
+- `tns run ios` - call this command on a Mac computer to get your project deployed and started on a device attached to your computer
+- `tns run android` - call this command on a Mac/Windows/Linux computer to get your project deployed and started on an Android device, attached to your computer.
+
+![tns emulate ios *nix](img/cli/tns-emulate-ios-unix.png "tns emulate ios *nix")
+![tns emulate android windows](img/cli/tns-emulate-android-windows.png "tns emulate android windows")
+
diff --git a/img/cli/finder-app-created.png b/img/cli/finder-app-created.png
diff --git a/img/cli/tns-create-unix.png b/img/cli/tns-create-unix.png
diff --git a/img/cli/tns-create-windows.png b/img/cli/tns-create-windows.png
diff --git a/img/cli/tns-emulate-android-windows.png b/img/cli/tns-emulate-android-windows.png
diff --git a/img/cli/tns-emulate-ios-unix.png b/img/cli/tns-emulate-ios-unix.png
diff --git a/img/cli/tns-platform-add-android-windows.png b/img/cli/tns-platform-add-android-windows.png
diff --git a/img/cli/tns-platform-add-ios-unix.png b/img/cli/tns-platform-add-ios-unix.png
diff --git a/img/cli/tns-prepare-android-windows.png b/img/cli/tns-prepare-android-windows.png
diff --git a/index.md b/index.md
@@ -11,7 +11,7 @@ NativeScript enables developers to build native application for iOS and Android
 
 A NativeScript application consists of pure JavaScript code, executing within native android and ios runtimes. NativeScript includes purposely built JavaScript modules, i.e. a NativeScript UI framework to enable cross-platform code.
 
-Use the [NativeScript CLI](http://www.telerik.com/forums/using-the-cli-to-build-a-nativescript-application-f3de79aa6c37) to create an application.
+Use the [NativeScript CLI](cli.md) to create an application.
 
 Read the advanced topics below or refer to the [Api Reference](ApiReference/) to build a powerful NativeScript application: