1 | ## Ionic Framework
|
2 |
|
3 | The official npm package for [Ionic](https://ionicframework.com/), complete with pre-built ES5 bundles, TypeScript definitions, Sass files, CommonJS ES5 files, and more.
|
4 |
|
5 | To get started with Ionic, please read the [Installation Guide](https://ionicframework.com/docs/intro/installation/).
|
6 |
|
7 | [Ionic Documentation](https://ionicframework.com/docs/)
|
8 |
|
9 | ### Source files
|
10 |
|
11 | In the root of the package are ES5 sources in the CommonJS module format, their associated Typescript type definition files, and the Ionic Sass entry files. The Javascript sources are meant to be used by a bundler such as Webpack, SystemJS Builder, or Browserify. The type definitions provide support to Typescript tooling for things like type checking and code completion.
|
12 |
|
13 | Usually, the only import required by the user is `ionic-angular`, as everything from Ionic is exported by the package:
|
14 |
|
15 | ```
|
16 | import { App, NavController } from 'ionic-angular';
|
17 | ```
|
18 |
|
19 | ### Bundles
|
20 |
|
21 | Minified and unminified CommonJS and System.register module format bundles, as well as compiled CSS stylesheets for both Ionic iOS and Material Design are located `bundles/`. The SystemJS bundle is primarily meant to be included in a `<script>` tag for demos, tests and Javascript playgrounds like [Plunker](https://plnkr.co/).
|
22 |
|
23 | ### Installation and More
|
24 |
|
25 | To use Ionic, we recommend installing and utilizing the [Ionic CLI](https://ionicframework.com/docs/intro/installation/) which will help you create pre-configured Ionic apps.
|
26 |
|
27 | For full instructions on using Ionic, please visit the [Ionic Documentation](https://ionicframework.com/docs/)
|