{"_id":"56d1f33a00a2a70b00b365c3","user":"5526ca4cf69851170038b496","version":{"_id":"56d1f33700a2a70b00b3658e","project":"5526c95cf69851170038b48f","__v":2,"createdAt":"2016-02-27T19:04:23.946Z","releaseDate":"2016-02-27T19:04:23.946Z","categories":["56d1f33900a2a70b00b3658f","56d1f33900a2a70b00b36590","56d1f33900a2a70b00b36591","56d1f33900a2a70b00b36592","56d1f33900a2a70b00b36593","56d1f33900a2a70b00b36594","56d1f33900a2a70b00b36595","56d1f33900a2a70b00b36596","56d1f33900a2a70b00b36597","56d1f33900a2a70b00b36598","56d1f33900a2a70b00b36599","56d1f33900a2a70b00b3659a","571f9497ada30c34003b7cee"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"beta","version_clean":"2.0.0-beta","version":"2.0.0-beta"},"__v":6,"category":{"_id":"56d1f33900a2a70b00b3658f","version":"56d1f33700a2a70b00b3658e","__v":1,"pages":["56d1f33a00a2a70b00b365c1","56d1f33a00a2a70b00b365c2","56d1f33a00a2a70b00b365c3","56d1f33a00a2a70b00b365c4","56d1f33a00a2a70b00b365c5","56d1f33a00a2a70b00b365c6","56d1f33a00a2a70b00b365c7","56d1f33a00a2a70b00b365c8","56d1f33a00a2a70b00b365c9","56d1f33a00a2a70b00b365ca","56d1f33a00a2a70b00b365cb","56d1f33a00a2a70b00b365cc","56d1f33a00a2a70b00b365cd","56d1f33a00a2a70b00b365ce","56d1f33a00a2a70b00b365cf","56d1f33a00a2a70b00b365d0","56d1f33a00a2a70b00b365d1","56d1f33a00a2a70b00b365d2"],"project":"5526c95cf69851170038b48f","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-04-10T13:13:56.755Z","from_sync":false,"order":0,"slug":"getting-started","title":"Getting Started"},"parentDoc":null,"project":"5526c95cf69851170038b48f","updates":["572a0382fcecb90e00b0aa01","5752afdb76b3b70e0007f2e5","575d81054382940e0095637d","57680464d8067e1900fc81bf","5783e23a192dcf0e0099831e"],"next":{"pages":[],"description":""},"createdAt":"2015-09-22T13:27:43.763Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":1,"body":"[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"Support for Ionic 2\",\n  \"body\": \"We have prioritized adding support for Ionic 2, but as it stands you will get errors when trying to add the platform web client into an Ionic 2 project.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"You should be able to [login](https://apps.ionic.io/login) to the dashboard at this point. If you haven't created an Ionic Platform account yet, you will need to [sign up](https://apps.ionic.io/signup).\\n\\nYou should also be comfortable with using the [Ionic Framework](http://ionicframework.com/getting-started/) and [Ionic CLI](https://github.com/driftyco/ionic-cli) before proceeding.\",\n  \"title\": \"Prerequisites\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\"\n}\n[/block]\n## Create your app\n\nYou'll need to start a new app using the `ionic start` command. Later, you can learn how to hook up an [existing app](doc:io-existing-app). In your CLI, navigate to where you want to start your new app and run:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"$ ionic start APPNAME\\n$ cd APPNAME\",\n      \"language\": \"shell\"\n    }\n  ]\n}\n[/block]\nMake sure to replace `APPNAME` with a name of your choosing, but just be aware that we'll continue to use `APPNAME` when we want you to use the name of the app you chose.\n[block:api-header]\n{\n  \"type\": \"basic\"\n}\n[/block]\nNow you can add the platform web client:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"$ ionic add ionic-platform-web-client\",\n      \"language\": \"shell\"\n    }\n  ]\n}\n[/block]\nThe web client gives you a way to interact with the Ionic Platform services from within your app code.\n[block:api-header]\n{\n  \"type\": \"basic\"\n}\n[/block]\n## Hook up with Ionic Platform\n\nIn the previous step, you created a standard Ionic app. Now, we need the Platform to assign your app a unique [app id](doc:io-api-keys) and [api key](doc:io-api-keys). To do that, we will use the `ionic io init` command. \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"$ ionic io init\",\n      \"language\": \"shell\"\n    }\n  ]\n}\n[/block]\nThis will automatically prompt you to login to your Platform account. The app id and api key will then be stored in your project's Ionic Platform [config](doc:io-config).\n\nYour app is now hooked up to the Ionic Platform and will be listed in your [Dashboard](https://apps.ionic.io).\n[block:api-header]\n{\n  \"type\": \"basic\"\n}\n[/block]\n## Next Steps\n\nYou should now have an app created that is hooked up to the Ionic Platform. You're all set to begin [adding services](doc:io-adding-services).","excerpt":"Learn how to create your first app or integrate an existing one with Ionic.io","slug":"io-install","type":"basic","title":"Setup"}

Setup

Learn how to create your first app or integrate an existing one with Ionic.io

[block:callout] { "type": "danger", "title": "Support for Ionic 2", "body": "We have prioritized adding support for Ionic 2, but as it stands you will get errors when trying to add the platform web client into an Ionic 2 project." } [/block] [block:callout] { "type": "info", "body": "You should be able to [login](https://apps.ionic.io/login) to the dashboard at this point. If you haven't created an Ionic Platform account yet, you will need to [sign up](https://apps.ionic.io/signup).\n\nYou should also be comfortable with using the [Ionic Framework](http://ionicframework.com/getting-started/) and [Ionic CLI](https://github.com/driftyco/ionic-cli) before proceeding.", "title": "Prerequisites" } [/block] [block:api-header] { "type": "basic" } [/block] ## Create your app You'll need to start a new app using the `ionic start` command. Later, you can learn how to hook up an [existing app](doc:io-existing-app). In your CLI, navigate to where you want to start your new app and run: [block:code] { "codes": [ { "code": "$ ionic start APPNAME\n$ cd APPNAME", "language": "shell" } ] } [/block] Make sure to replace `APPNAME` with a name of your choosing, but just be aware that we'll continue to use `APPNAME` when we want you to use the name of the app you chose. [block:api-header] { "type": "basic" } [/block] Now you can add the platform web client: [block:code] { "codes": [ { "code": "$ ionic add ionic-platform-web-client", "language": "shell" } ] } [/block] The web client gives you a way to interact with the Ionic Platform services from within your app code. [block:api-header] { "type": "basic" } [/block] ## Hook up with Ionic Platform In the previous step, you created a standard Ionic app. Now, we need the Platform to assign your app a unique [app id](doc:io-api-keys) and [api key](doc:io-api-keys). To do that, we will use the `ionic io init` command. [block:code] { "codes": [ { "code": "$ ionic io init", "language": "shell" } ] } [/block] This will automatically prompt you to login to your Platform account. The app id and api key will then be stored in your project's Ionic Platform [config](doc:io-config). Your app is now hooked up to the Ionic Platform and will be listed in your [Dashboard](https://apps.ionic.io). [block:api-header] { "type": "basic" } [/block] ## Next Steps You should now have an app created that is hooked up to the Ionic Platform. You're all set to begin [adding services](doc:io-adding-services).