2015-03-06 12:53:39 -05:00
Angular [![Build Status ](https://travis-ci.org/angular/angular.svg?branch=master )](https://travis-ci.org/angular/angular) [![Join the chat at https://gitter.im/angular/angular ](https://badges.gitter.im/Join%20Chat.svg )](https://gitter.im/angular/angular?utm_source=badge& utm_medium=badge& utm_campaign=pr-badge& utm_content=badge)
2015-01-04 18:12:48 -05:00
=========
2014-09-29 17:20:23 -04:00
2015-03-17 21:48:02 -04:00
Angular is a development platform for building mobile and desktop web applications. This is the
repository for [Angular 2][ng2], both the JavaScript (JS) and [Dart][dart] versions.
2015-03-06 12:53:39 -05:00
2015-03-17 21:48:02 -04:00
Angular 2 is currently in **Alpha Preview** . We recommend using Angular 1.X for production
applications:
2015-01-07 05:27:39 -05:00
2015-03-17 21:48:02 -04:00
* [AngularJS][ngJS]: [angular/angular.js ](http://github.com/angular/angular.js ).
* [AngularDart][ngDart]: [angular/angular.dart ](http://github.com/angular/angular.dart ).
2014-09-28 16:55:01 -04:00
2015-01-09 19:29:34 -05:00
2015-03-17 21:48:02 -04:00
## Setup & Install Angular 2
2014-09-28 16:55:01 -04:00
2015-03-17 21:48:02 -04:00
Follow the instructions given on the [Angular download page][download].
2014-09-28 16:55:01 -04:00
2015-03-17 21:48:02 -04:00
## Want to help?
2014-09-28 16:55:01 -04:00
2015-03-17 21:48:02 -04:00
Want to file a bug, or contribute some code or improve documentation? Excellent! Read up on our
guidelines for [contributing][contributing].
2014-09-28 16:55:01 -04:00
2015-03-17 21:48:02 -04:00
## Examples
2014-09-28 16:55:01 -04:00
2015-03-17 21:48:02 -04:00
To see the examples, first build the project as described
[here ](http://github.com/angular/angular/blob/master/DEVELOPER.md ).
2014-09-28 16:55:01 -04:00
2015-03-17 21:48:02 -04:00
### Hello World Example
2014-09-28 16:55:01 -04:00
2015-03-17 21:48:02 -04:00
This example consists of three basic pieces - a component, a decorator and a
service. They are all constructed via injection. For more information see the
comments in the source `modules/examples/src/hello_world/index.js` .
2014-11-21 18:17:00 -05:00
You can build this example as either JS or Dart app:
2014-10-29 12:52:15 -04:00
2015-03-17 21:48:02 -04:00
* JS:
2015-03-19 04:59:51 -04:00
* `$(npm bin)/gulp build.js.dev` , and
2015-03-17 21:48:02 -04:00
* `$(npm bin)/gulp serve.js.dev` , and
* open `localhost:8000/examples/src/hello_world/` in Chrome.
* Dart:
* `$(npm bin)/gulp serve/examples.dart` , and
* open `localhost:8080/src/hello_world` in Chrome (for dart2js) or
[Dartium][dartium] (for Dart VM).
[contributing]: http://github.com/angular/angular/blob/master/CONTRIBUTING.md
[dart]: http://www.dartlang.org
[dartium]: http://www.dartlang.org/tools/dartium
[download]: http://angular.io/download
[ng2]: http://angular.io
[ngDart]: http://angulardart.org
[ngJS]: http://angularjs.org