Improve this doc

Including angular scripts from the Google CDN

The quickest way to get started is to point your html tag to a Google CDN URL. This way, you don't have to download anything or maintain a local copy.

There are two types of angular script URLs you can point to, one for development and one for production:

  • angular.js — This is the human-readable, non-minified version, suitable for web development.
  • angular.min.js — This is the minified version, which we strongly suggest you use in production.

To point your code to an angular script on the Google CDN server, use the following template. This example points to the minified version 1.2.0:

  1.   <!doctype html>
  2.   <html ng-app>
  3.     <head>
  4.       <title>My Angular App</title>
  5.       <script src="https://ajax.googleapis.com/ajax/libs/angularjs/1.2.0/angular.min.js"></script>
  6.     </head>
  7.     <body>
  8.     </body>
  9.   </html>

Note that only versions 1.0.1 and above are available on the CDN, if you need an earlier version you can use the http://code.angularjs.org/ URL which was the previous recommended location for hosted code source. If you're still using the angular server you should switch to the CDN version for even faster loading times.

Downloading and hosting angular files locally

This option is for those who want to work with angular offline, or those who want to host the angular files on their own servers.

If you navigate to http://code.angularjs.org/, you'll see a directory listing with all of the angular versions since we started releasing versioned build artifacts (quite late in the project lifetime). Each directory contains all artifacts that we released for a particular version. Download the version you want and have fun.

Each directory under http://code.angularjs.org/ includes the following set of files:

  • angular.js — This file is non-obfuscated, non-minified, and human-readable by opening it it any editor or browser. In order to get better error messages during development, you should always use this non-minified angular script.

  • angular.min.js — This is a minified and obfuscated version of angular.js created with the Closure compiler. Use this version for production in order to minimize the size of the application that is downloaded by your user's browser.

  • angular.zip — This is a zip archive that contains all of the files released for this angular version. Use this file to get everything in a single download.

  • angular-mocks.js — This file contains an implementation of mocks that makes testing angular apps even easier. Your unit/integration test harness should load this file after angular.js is loaded.

  • angular-scenario.js — This file is a very nifty JavaScript file that allows you to write and execute end-to-end tests for angular applications.

  • angular-loader.min.js — Module loader for Angular modules. If you are loading multiple script files containing Angular modules, you can load them asynchronously and in any order as long as you load this file first. Often the contents of this file are copy&pasted into the index.html to avoid even the initial request to angular-loader.min.js. See angular-seed for an example of usage.

  • Additional Angular modules: optional modules with additional functionality. These files should be loaded after the core angular.js file:

    • angular-animate.js - Enable animation support
    • angular-cookies.js - A convenient wrapper for reading and writing browser cookies
    • angular-resource.js - Interaction support with RESTful services via the $resource service
    • angular-route.js - Routing and deeplinking services and directives for angular apps
    • angular-sanitize.js - Functionality to sanitize HTML
    • angular-touch.js - Touch events and other helpers for touch-enabled devices

  • docs — this directory contains all the files that compose the http://docs.angularjs.org/ documentation app. These files are handy to see the older version of our docs, or even more importantly, view the docs offline.

  • i18n - this directory contains locale specific ngLocale angular modules to override the defaults defined in the ng module.