Stormpath AngularJS SDK [BETA]

A simple user authentication library for AngularJS.

This library provides services and directives for AngularJS that will allow you to solve these common user management tasks in your AngularJS application:

• Register new users
• Login users
• Verify new accounts via email tokens
• Secure password reset via email tokens
• Conditionally render parts of your UI, based on login state
• Control access to application routes

Under the hood, this library uses Oauth Access Tokens (JWTs) as the authentication mechanism. This library implements the best-practice approaches that we outline in Token Based Authentication for Single Page Apps (SPAs).

If you have feedback about this library, please get in touch and share your thoughts! [email protected]

Stormpath is a User Management API that reduces development time with instant-on, scalable user infrastructure. Stormpath's intuitive API and expert support make it easy for developers to authenticate, manage, and secure users and roles in any application.

Hot screenshots

Curious? Here's some screenies that show you what's included:

Registration Forms </td> <td width="33%" align="center" valign="top"> <p><strong>Logins Forms</strong></p> <center><img src="http://docs.stormpath.com/angularjs/guide/_images/login_form.png"></center> </td> <td width="33%" align="center" valign="top"> <p><strong>User Profile Information</strong></p> <center><img src="http://docs.stormpath.com/angularjs/guide/_images/profile_view.png"></center> </td>

Installation

If you are using Bower, simply install it:

bower install --save stormpath-sdk-angularjs

If you want to manually load the minified scripts, you can grab them from the dist folder in this repo and include them manually:

<script src="stormpath-sdk-angularjs.min.js"></script>
<script src="stormpath-sdk-angularjs.tpls.min.js"></script>

You can then require the Stormpath modules in your application:

var myApp = angular.module('myApp', ['stormpath','stormpath.templates']);

The templates are optional, see the documentation for more information.

Documentation & Guide

If you are starting a new project, the Stormpath AngularJS Guide will be your best choice. It will help you get started with a new project and an API server for your application.

If you already have an Angular project, you will want to visit the Stormpath AngularJS SDK API Documenation. That documentation will show you all the available directives and services that you can use in your application.

Example application

This repository contains a working example application in the example/dashboard-app folder. This is the application that we build in the Stormpath AngularJS Guide. If you would like to skip the guide and start using the example application, do the following:

1. Install Bower and Grunt if you don't already have them

2. Clone this repo

3. In your terminal, change directories to the example/dashboard-app folder

4. Run npm install && bower install

5. Copy the file example/dashboard-app/server/config/local.env.sample.js to local.env.js (in the same directory) and add your Stormpath variables for the Stormpath Applicaiton that you will be using.

6. Run grunt serve to start the example application, which will be available at http://localhost:9000

Contributing

Found something you want to change? Please see the Contribution Guide, we love your input!