diff --git a/GUIDE.md b/GUIDE.md new file mode 100644 index 0000000000..1f8c03b702 --- /dev/null +++ b/GUIDE.md @@ -0,0 +1,31 @@ +# Ionic + +Ionic makes it easy for web developers to best-in-class build mobile apps across major platforms, like iOS +and Android. + +Since the initial release of Ionic in November 2013, 700,000 apps have been created with the Ionic SDK, +and many have been featured as top apps in the Apple App Store, Google Play Store, and Amazon App Store. + +Ionic is a collection of CSS and Javascript components based on Angular 2. The core philosophy behind +Ionic is that a web developer can use the standard HTML5/CSS/Javascript stack they already know and love, +but get real mobile components underneath that adapt automatically to the device and platform they +run on. + +## New to Ionic? + +If Ionic 2 is your first exposure to Ionic, jump right in with the [Getting Started]() guide. Otherwise, +read below for some design philosophy changes from v1. + +## New Concepts in Ionic 2 + +Ionic 2 brings even more parity to native SDKs like iOS and Android for the web stack. + +With that in mind, some core components (like routing) work differently in v2 than v1. + +### Navigation + +In Ionic 1, we used UI Router with URL routing heavily to define navigation in your app. + +The overwhelming feedback from Ionic 1 developers is that the routing and navigation +system was too difficult to use in practice. It was challenging to correctly map +URLs to views, and the navigation system didn't give the developer enough fine-grained control. diff --git a/README.md b/README.md index 5c1ee49522..75e6a13405 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,11 @@ +# Ionic 2 + +Ionic 2 is the next generation of [Ionic](http://ionicframework.com/), the popular open-source mobile app development SDK that makes it easy to build top quality mobile apps with web technologies. + +Ionic 2 is based on the new 2.x version of AngularJS, and comes with many significant performance, usability, +and feature improvements. + +For a quick intro to Ionic 2, see the [guide](GUIDE.md). #### Building & Running @@ -26,4 +34,3 @@ Note: Once you're setup, you just need to run `gulp watch`, unless you've update import {Component, Directive} from 'angular2/src/core/annotations_impl/annotations'; import {View} from 'angular2/src/core/annotations_impl/view'; ``` -