A reference app for building single page apps (SPA) with ASP.NET Web API 2 and AngularJS
JavaScript CSS C#
Latest commit 28bea19 Jun 9, 2014 @shijuvar shijuvar Update LICENSE.md

README.md

WebApi-AngularJS-Spa v1.2.0

alt text

A reference app for building single page apps (SPA) with ASP.NET Web API 2 and AngularJS, developed by Marlabs

Technologies

Server-Side

  • ASP.NET Web API 2
  • EF 6 Code First
  • AutoMapper
  • Autofac

Client-Side

  • AngularJS
  • Semantic UI
  • Gulp.js
  • Jasmine

Building the application

Visual Studio

  1. Build the solution to install Nuget packages.(This will automatically restore Nuget packages. Please ensure you have Nuget version 2.7 or higher)
  2. The Project ResourceMetada.API is configured to run using IIS Express.
  3. Before starting the Client Application (ResourceMetadata.Web), please ensure that the API project is running in IIS or IIS express.

Client-Side

  1. Config.js file at source/ResourceMetadata/ResourceMetadata.Web/Scripts/config.js holds the api url used by the Client application. Update this file to change the api url appropriately.
  2. If you haven't installed Node.js, download and install it from http://nodejs.org/
  3. Navigate to the directory of ResourceMetadata.Web project source/ResourceMetadata/ResourceMetadata.Web/ in command prompt.
  4. Run command npm install
  5. Execute gulp tasks
    1. Run command gulp build.
    2. In order to clean the destination files created by build task, run gulp cleanbuild.
    3. To run unit tests, run the command gulp tests

Migrating from Previous Versions

If you are already using the previous versions of the App, please drop the database ResourceMetadata from your SQL server before running the Application.

Changes in v1.2.0

  • Added unit tests for client-side JavaScript with Jasmine.
  • Added paging with ng-Table.
  • Role based security for both server-side and client-side.

Role Based Security

Role based security has been implemented on both client-side and server-side. Write operations on the "Location" entity is restricted with admin role. There is a pre-defined admin user with credentials admin@marlabs.com/Marlabs

Current Features

  • REST API with ASP.NET Web API 2.
  • Server-Side security with ASP.NET Identity.
  • Single Page Application(SPA) with AngularJS.
  • AngularJS factory $resource for interacting with RESTful server-side data sources.
  • AngularJS $http interceptors.
  • AngularJS directives.
  • Task automation with Gulp.js
  • Unit tests for client-side JavaScript with Jasmine.
  • Paging using ng-Table.
  • Role based security.

Roadmap Targets

  • Leverage Browserify
  • Performance optimizations and best prarctices for SPA.
  • Enhanced security model for SPA.
  • Next-generation hybrid mobile apps with HTML5 and AngularJS.

Team