{"action":"created","comment":{"url":"https://api.github.com/repos/NativeScript/docs/pulls/comments/38197821","id":38197821,"diff_hunk":"@@ -1,51 +1,1588 @@\n ---\n-nav-title: \"Getting Started with NativeScript\"\n-title: \"Getting Started\"\n-description: \"Learn the basics of of how NativeScript work, how to set up your system and how to create your first Hello World app\"\n+nav-title: \"Getting Started Guide\"\n+title: \"Getting Started Guide\"\n+description: \"Learn the basics of how NativeScript works, how to set up your system, and how to create your first app\"\n position: 2\n+guide: true\n ---\n \n-# Getting Started\n+## NativeScript Getting Started Guide\n \n-NativeScript strips the complexity from native development both in terms of required coding skills and system setup. \n+Welcome to the [NativeScript](https://nativescript.org) getting started guide. In this guided tutorial you'll use NativeScript, a cross-platform JavaScript framework for building native mobile apps, to build an iOS and Android app from scratch.\n \n-To get started, you need JavaScript or TypeScript knowledge to implement your business logic, XML and CSS knowledge to design your UI and an idea for a mobile app. You do not need Java or Objective-C knowledge.\n+> **Note**: If you'd prefer a video introduction to NativeScript, check out our [getting started guide on YouTube](https://www.youtube.com/watch?v=rsCT5fpES4Q).\n \n-Once you have your app idea, you can get started in a few minutes.\n+### What you're building\n \n-<iframe width=\"640\" height=\"360\" src=\"https://www.youtube.com/embed/rsCT5fpES4Q?rel=0\" frameborder=\"0\" allowfullscreen></iframe>\n+This guide will walk you through building [Groceries](https://github.com/NativeScript/sample-Groceries), a groceries-management app that does the following things:\n \n-You can find more details about each step of the setup and project creation process below and at the referenced pages of the documentation.\n+- Connects to an existing RESTful service.\n+- Allows users to register and login.\n+- Allows authenticated users to add and delete groceries from a list.\n+- Runs cross-platform—i.e. iOS and Android.\n \n-### 1. Choose your tools and **[set up your system](setup/quick-setup.md)**.\n+If you follow along to the end, here's what the finished app will look like on iOS:\n \n-If you are familiar with the Cordova CLI or if you want to develop and build your apps locally and free of charge, you can set up your system with the **NativeScript CLI**.\n-\t\n-* [Windows setup](setup/ns-cli-setup/ns-setup-win.md)\n-* [OS X setup](setup/ns-cli-setup/ns-setup-os-x.md)\n-* [Linux setup](setup/ns-cli-setup/ns-setup-linux.md)\n+![login](img/cli-getting-started/chapter0/ios/1.png)\n+![register](img/cli-getting-started/chapter0/ios/2.png)\n+![list](img/cli-getting-started/chapter0/ios/3.png)\n \n-If you prefer to concentrate on development and build your apps with a third-party build service, you can use the [Telerik AppBuilder tools](setup/ab-setup/ab-web-setup.md).\n-\t\n-* [In-browser IDE](setup/ab-setup/ab-web-setup.md)\n-* [Windows IDE](setup/ab-setup/ab-win-setup.md)\n-* [Extension for Visual Studio](setup/ab-setup/ab-vse-setup.md)\n-* [CLI](setup/ab-setup/ab-cli-setup.md)\n+And here's what the app will look like on Android:\n \n-### 2. Go through the **Hello World** tutorial for your preferred tool set.\n+![](img/cli-getting-started/chapter0/android/1.png)\n+![](img/cli-getting-started/chapter0/android/2.png)\n+![](img/cli-getting-started/chapter0/android/3.png)\n \n-This quick start development guide will introduce you to the basic architecture of a NativeScript app, data binding and how to implement user interfaces and styling.\n \n-* [Hello World from the NativeScript CLI](hello-world/hello-world-ns-cli.md)\n-* [Hello World from AppBuilder](hello-world/hello-world-appbuilder.md)\n+## Getting up and running\n \n-### 3. Learn from the full app samples prepared by the NativeScript team.\n+In this chapter you're going to start with the basics, including installing the NativeScript CLI, starting a new project, and getting your first app up and running.\n \n-[Sample apps with open source code](samples.md)\n+### Install NativeScript and configure your environment\n \n-### 4. Explore the **[modules overview](modules.md)** and the **[API Reference](ApiReference/application/README.md)**.\n+The NativeScript CLI has a few system requirements you must have in place before building NativeScript apps. As a first step, start by going through the appropriate instructions below depending on your development machine's operating system:\n \n-The extensive overview and API reference will introduce to the how-tos of NativeScript development. You will learn how to tap into the native capabilities that you want to implement inside your app.\n+- [Windows](http://docs.nativescript.org/setup/ns-cli-setup/ns-setup-win.html)\n+- [OS X](http://docs.nativescript.org/setup/ns-cli-setup/ns-setup-os-x.html)\n+- [Linux](http://docs.nativescript.org/setup/ns-cli-setup/ns-setup-linux.html)\n \n-# Remarks\n-If you hit some unexpected behavior please check the [Troubleshooting](./troubleshooting.md) article.\n+> **Tip**: If you're a bit overwhelmed by these requirements, or if you're looking for a way to build iOS apps on Windows, you might be interested in [using NativeScript through Telerik AppBuilder](http://docs.nativescript.org/setup/quick-setup#the-appbuilder-tool-set). Telerik AppBuilder provides tooling for NativeScript apps, including the ability to perform iOS and Android builds in the cloud, which removes the need to complete these system requirements.\n+\n+After completing the setup you should have two commands available from your terminal: `tns`—which is short for <b>T</b>elerik <b>N</b>ative<b>S</b>cript—and `nativescript`. The two commands are equivalent, so we'll stick with the shorter `tns` command throughout this guide.\n+\n+You can verify the installation was successful by running `tns` in your terminal. You should see something like this:\n+\n+```\n+$ tns\n+# NativeScript\n+┌─────────┬─────────────────────────────────────────────────────────────────────┐\n+│ Usage   │ Synopsis                                                            │\n+│ General │ $ tns <Command> [Command Parameters] [--command <Options>]          │\n+│ Alias   │ $ nativescript <Command> [Command Parameters] [--command <Options>] │\n+└─────────┴─────────────────────────────────────────────────────────────────────┘\n+```\n+\n+### Start your app\n+\n+With the NativeScript CLI installed, it's time to start building your app. Normally, you would [use the `tns create` command to create an empty NativeScript application](https://github.com/NativeScript/NativeScript-cli#create-project)—e.g. `tns create hello-world`—but for this guide we've scaffolded out a boilerplate project to act as a starting point for [Groceries](https://github.com/NativeScript/sample-Groceries).\n+\n+<h4 class=\"exercise-start\">\n+    <b>Exercise</b>: Get the Groceries starting point\n+</h4>\n+\n+Navigate to a folder where you want to keep your app's code:\n+\n+<div class=\"no-copy-button\"></div>\n+\n+```\n+cd the-folder-you-want-groceries-to-be-in\n+```\n+\n+Next, clone the Groceries repo from GitHub:\n+\n+```\n+git clone https://github.com/NativeScript/sample-Groceries.git","path":"getting-started.md","position":115,"original_position":115,"commit_id":"e5b6e3477e5a18a80fb606b31eca0ae18b7a22cf","original_commit_id":"e5b6e3477e5a18a80fb606b31eca0ae18b7a22cf","user":{"login":"ikoevska","id":3539221,"avatar_url":"https://avatars.githubusercontent.com/u/3539221?v=3","gravatar_id":"","url":"https://api.github.com/users/ikoevska","html_url":"https://github.com/ikoevska","followers_url":"https://api.github.com/users/ikoevska/followers","following_url":"https://api.github.com/users/ikoevska/following{/other_user}","gists_url":"https://api.github.com/users/ikoevska/gists{/gist_id}","starred_url":"https://api.github.com/users/ikoevska/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ikoevska/subscriptions","organizations_url":"https://api.github.com/users/ikoevska/orgs","repos_url":"https://api.github.com/users/ikoevska/repos","events_url":"https://api.github.com/users/ikoevska/events{/privacy}","received_events_url":"https://api.github.com/users/ikoevska/received_events","type":"User","site_admin":false},"body":"Hm, I don't think that we require git for the NS CLI. There is no guarantee that users will have it installed. You need to point this additional requirement above.","created_at":"2015-08-28T13:15:49Z","updated_at":"2015-08-28T13:15:49Z","html_url":"https://github.com/NativeScript/docs/pull/128#discussion_r38197821","pull_request_url":"https://api.github.com/repos/NativeScript/docs/pulls/128","_links":{"self":{"href":"https://api.github.com/repos/NativeScript/docs/pulls/comments/38197821"},"html":{"href":"https://github.com/NativeScript/docs/pull/128#discussion_r38197821"},"pull_request":{"href":"https://api.github.com/repos/NativeScript/docs/pulls/128"}}},"pull_request":{"url":"https://api.github.com/repos/NativeScript/docs/pulls/128","id":42842321,"html_url":"https://github.com/NativeScript/docs/pull/128","diff_url":"https://github.com/NativeScript/docs/pull/128.diff","patch_url":"https://github.com/NativeScript/docs/pull/128.patch","issue_url":"https://api.github.com/repos/NativeScript/docs/issues/128","number":128,"state":"open","locked":false,"title":"New quick start","user":{"login":"tjvantoll","id":544280,"avatar_url":"https://avatars.githubusercontent.com/u/544280?v=3","gravatar_id":"","url":"https://api.github.com/users/tjvantoll","html_url":"https://github.com/tjvantoll","followers_url":"https://api.github.com/users/tjvantoll/followers","following_url":"https://api.github.com/users/tjvantoll/following{/other_user}","gists_url":"https://api.github.com/users/tjvantoll/gists{/gist_id}","starred_url":"https://api.github.com/users/tjvantoll/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tjvantoll/subscriptions","organizations_url":"https://api.github.com/users/tjvantoll/orgs","repos_url":"https://api.github.com/users/tjvantoll/repos","events_url":"https://api.github.com/users/tjvantoll/events{/privacy}","received_events_url":"https://api.github.com/users/tjvantoll/received_events","type":"User","site_admin":false},"body":"Ping @atanasovg @hdeshev \r\n\r\nI was able to get the Jekyll setup working which helped a lot for testing this. Here's the side nav I was talking about:\r\n\r\n![screen shot 2015-08-19 at 1 09 19 pm](https://cloud.githubusercontent.com/assets/544280/9363812/8d463210-4676-11e5-8a8b-df5573521087.png)\r\n\r\nThe two problems are that, 1) this requires a bit of CSS and JavaScript to get working (see the top and bottom of [this file](https://raw.githubusercontent.com/tjvantoll/docs/83e2ac5899c4035f4c8c89e4f8eb5a8fe08eadad/getting-started.md)), and 2) the nav isn't fixed like it is on <http://nativescript.github.io/quick-start/>. I can make it work, but it gets really hacky as I basically have to reimplement the site's layout for this page.\r\n\r\nThe being said, other than those two things I was pleasantly surprised by how easy it was to port this content and get everything working. Let me know what you think.","created_at":"2015-08-19T17:38:09Z","updated_at":"2015-08-28T13:15:49Z","closed_at":null,"merged_at":null,"merge_commit_sha":"9fa8dfc684a4efbedda6c5912c7abf00cf1338a4","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/NativeScript/docs/pulls/128/commits","review_comments_url":"https://api.github.com/repos/NativeScript/docs/pulls/128/comments","review_comment_url":"https://api.github.com/repos/NativeScript/docs/pulls/comments{/number}","comments_url":"https://api.github.com/repos/NativeScript/docs/issues/128/comments","statuses_url":"https://api.github.com/repos/NativeScript/docs/statuses/e5b6e3477e5a18a80fb606b31eca0ae18b7a22cf","head":{"label":"tjvantoll:new-quick-start","ref":"new-quick-start","sha":"e5b6e3477e5a18a80fb606b31eca0ae18b7a22cf","user":{"login":"tjvantoll","id":544280,"avatar_url":"https://avatars.githubusercontent.com/u/544280?v=3","gravatar_id":"","url":"https://api.github.com/users/tjvantoll","html_url":"https://github.com/tjvantoll","followers_url":"https://api.github.com/users/tjvantoll/followers","following_url":"https://api.github.com/users/tjvantoll/following{/other_user}","gists_url":"https://api.github.com/users/tjvantoll/gists{/gist_id}","starred_url":"https://api.github.com/users/tjvantoll/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tjvantoll/subscriptions","organizations_url":"https://api.github.com/users/tjvantoll/orgs","repos_url":"https://api.github.com/users/tjvantoll/repos","events_url":"https://api.github.com/users/tjvantoll/events{/privacy}","received_events_url":"https://api.github.com/users/tjvantoll/received_events","type":"User","site_admin":false},"repo":{"id":20927953,"name":"docs","full_name":"tjvantoll/docs","owner":{"login":"tjvantoll","id":544280,"avatar_url":"https://avatars.githubusercontent.com/u/544280?v=3","gravatar_id":"","url":"https://api.github.com/users/tjvantoll","html_url":"https://github.com/tjvantoll","followers_url":"https://api.github.com/users/tjvantoll/followers","following_url":"https://api.github.com/users/tjvantoll/following{/other_user}","gists_url":"https://api.github.com/users/tjvantoll/gists{/gist_id}","starred_url":"https://api.github.com/users/tjvantoll/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tjvantoll/subscriptions","organizations_url":"https://api.github.com/users/tjvantoll/orgs","repos_url":"https://api.github.com/users/tjvantoll/repos","events_url":"https://api.github.com/users/tjvantoll/events{/privacy}","received_events_url":"https://api.github.com/users/tjvantoll/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/tjvantoll/docs","description":"Docs, API Reference and Code Snippets for NativeScript","fork":true,"url":"https://api.github.com/repos/tjvantoll/docs","forks_url":"https://api.github.com/repos/tjvantoll/docs/forks","keys_url":"https://api.github.com/repos/tjvantoll/docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/tjvantoll/docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/tjvantoll/docs/teams","hooks_url":"https://api.github.com/repos/tjvantoll/docs/hooks","issue_events_url":"https://api.github.com/repos/tjvantoll/docs/issues/events{/number}","events_url":"https://api.github.com/repos/tjvantoll/docs/events","assignees_url":"https://api.github.com/repos/tjvantoll/docs/assignees{/user}","branches_url":"https://api.github.com/repos/tjvantoll/docs/branches{/branch}","tags_url":"https://api.github.com/repos/tjvantoll/docs/tags","blobs_url":"https://api.github.com/repos/tjvantoll/docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/tjvantoll/docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/tjvantoll/docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/tjvantoll/docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/tjvantoll/docs/statuses/{sha}","languages_url":"https://api.github.com/repos/tjvantoll/docs/languages","stargazers_url":"https://api.github.com/repos/tjvantoll/docs/stargazers","contributors_url":"https://api.github.com/repos/tjvantoll/docs/contributors","subscribers_url":"https://api.github.com/repos/tjvantoll/docs/subscribers","subscription_url":"https://api.github.com/repos/tjvantoll/docs/subscription","commits_url":"https://api.github.com/repos/tjvantoll/docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/tjvantoll/docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/tjvantoll/docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/tjvantoll/docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/tjvantoll/docs/contents/{+path}","compare_url":"https://api.github.com/repos/tjvantoll/docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/tjvantoll/docs/merges","archive_url":"https://api.github.com/repos/tjvantoll/docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/tjvantoll/docs/downloads","issues_url":"https://api.github.com/repos/tjvantoll/docs/issues{/number}","pulls_url":"https://api.github.com/repos/tjvantoll/docs/pulls{/number}","milestones_url":"https://api.github.com/repos/tjvantoll/docs/milestones{/number}","notifications_url":"https://api.github.com/repos/tjvantoll/docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/tjvantoll/docs/labels{/name}","releases_url":"https://api.github.com/repos/tjvantoll/docs/releases{/id}","created_at":"2014-06-17T15:01:41Z","updated_at":"2015-02-11T21:12:43Z","pushed_at":"2015-08-24T16:36:05Z","git_url":"git://github.com/tjvantoll/docs.git","ssh_url":"git@github.com:tjvantoll/docs.git","clone_url":"https://github.com/tjvantoll/docs.git","svn_url":"https://github.com/tjvantoll/docs","homepage":null,"size":6303,"stargazers_count":0,"watchers_count":0,"language":null,"has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":1,"mirror_url":null,"open_issues_count":0,"forks":1,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"NativeScript:master","ref":"master","sha":"3e34134837f29006bad86c916719c25a2aa9bba2","user":{"login":"NativeScript","id":7392261,"avatar_url":"https://avatars.githubusercontent.com/u/7392261?v=3","gravatar_id":"","url":"https://api.github.com/users/NativeScript","html_url":"https://github.com/NativeScript","followers_url":"https://api.github.com/users/NativeScript/followers","following_url":"https://api.github.com/users/NativeScript/following{/other_user}","gists_url":"https://api.github.com/users/NativeScript/gists{/gist_id}","starred_url":"https://api.github.com/users/NativeScript/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/NativeScript/subscriptions","organizations_url":"https://api.github.com/users/NativeScript/orgs","repos_url":"https://api.github.com/users/NativeScript/repos","events_url":"https://api.github.com/users/NativeScript/events{/privacy}","received_events_url":"https://api.github.com/users/NativeScript/received_events","type":"Organization","site_admin":false},"repo":{"id":20398807,"name":"docs","full_name":"NativeScript/docs","owner":{"login":"NativeScript","id":7392261,"avatar_url":"https://avatars.githubusercontent.com/u/7392261?v=3","gravatar_id":"","url":"https://api.github.com/users/NativeScript","html_url":"https://github.com/NativeScript","followers_url":"https://api.github.com/users/NativeScript/followers","following_url":"https://api.github.com/users/NativeScript/following{/other_user}","gists_url":"https://api.github.com/users/NativeScript/gists{/gist_id}","starred_url":"https://api.github.com/users/NativeScript/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/NativeScript/subscriptions","organizations_url":"https://api.github.com/users/NativeScript/orgs","repos_url":"https://api.github.com/users/NativeScript/repos","events_url":"https://api.github.com/users/NativeScript/events{/privacy}","received_events_url":"https://api.github.com/users/NativeScript/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/NativeScript/docs","description":"Docs, API Reference and Code Snippets for NativeScript","fork":false,"url":"https://api.github.com/repos/NativeScript/docs","forks_url":"https://api.github.com/repos/NativeScript/docs/forks","keys_url":"https://api.github.com/repos/NativeScript/docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/NativeScript/docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/NativeScript/docs/teams","hooks_url":"https://api.github.com/repos/NativeScript/docs/hooks","issue_events_url":"https://api.github.com/repos/NativeScript/docs/issues/events{/number}","events_url":"https://api.github.com/repos/NativeScript/docs/events","assignees_url":"https://api.github.com/repos/NativeScript/docs/assignees{/user}","branches_url":"https://api.github.com/repos/NativeScript/docs/branches{/branch}","tags_url":"https://api.github.com/repos/NativeScript/docs/tags","blobs_url":"https://api.github.com/repos/NativeScript/docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/NativeScript/docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/NativeScript/docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/NativeScript/docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/NativeScript/docs/statuses/{sha}","languages_url":"https://api.github.com/repos/NativeScript/docs/languages","stargazers_url":"https://api.github.com/repos/NativeScript/docs/stargazers","contributors_url":"https://api.github.com/repos/NativeScript/docs/contributors","subscribers_url":"https://api.github.com/repos/NativeScript/docs/subscribers","subscription_url":"https://api.github.com/repos/NativeScript/docs/subscription","commits_url":"https://api.github.com/repos/NativeScript/docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/NativeScript/docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/NativeScript/docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/NativeScript/docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/NativeScript/docs/contents/{+path}","compare_url":"https://api.github.com/repos/NativeScript/docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/NativeScript/docs/merges","archive_url":"https://api.github.com/repos/NativeScript/docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/NativeScript/docs/downloads","issues_url":"https://api.github.com/repos/NativeScript/docs/issues{/number}","pulls_url":"https://api.github.com/repos/NativeScript/docs/pulls{/number}","milestones_url":"https://api.github.com/repos/NativeScript/docs/milestones{/number}","notifications_url":"https://api.github.com/repos/NativeScript/docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/NativeScript/docs/labels{/name}","releases_url":"https://api.github.com/repos/NativeScript/docs/releases{/id}","created_at":"2014-06-02T09:28:14Z","updated_at":"2015-08-17T18:48:49Z","pushed_at":"2015-08-27T22:13:28Z","git_url":"git://github.com/NativeScript/docs.git","ssh_url":"git@github.com:NativeScript/docs.git","clone_url":"https://github.com/NativeScript/docs.git","svn_url":"https://github.com/NativeScript/docs","homepage":null,"size":5563,"stargazers_count":219,"watchers_count":219,"language":null,"has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":47,"mirror_url":null,"open_issues_count":19,"forks":47,"open_issues":19,"watchers":219,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/NativeScript/docs/pulls/128"},"html":{"href":"https://github.com/NativeScript/docs/pull/128"},"issue":{"href":"https://api.github.com/repos/NativeScript/docs/issues/128"},"comments":{"href":"https://api.github.com/repos/NativeScript/docs/issues/128/comments"},"review_comments":{"href":"https://api.github.com/repos/NativeScript/docs/pulls/128/comments"},"review_comment":{"href":"https://api.github.com/repos/NativeScript/docs/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/NativeScript/docs/pulls/128/commits"},"statuses":{"href":"https://api.github.com/repos/NativeScript/docs/statuses/e5b6e3477e5a18a80fb606b31eca0ae18b7a22cf"}}}}