SoNet Starter Kit

This project is an application skeleton for an AngularJS web app, realized for the Social Networking course at Politecnico di Torino.

The Starter Kit contains a sample AngularJS application (the one reported in the official angular-seed. AngularJS (version 1.5.5) is included in the lib folder, together with the Bootstrap framework (version 3.3.6).

Moreover, the Starter Kit is preconfigured to install a bunch of development tools for easing the development of a project:

• browser-sync, a time-saving synchronized browser testing tool
• jshint, for JS linting, preconfigured for AngularJS
• firebase-tools, for deploying the webapp to the Firebase Hosting service.

The included app doesn't do much, just shows how to wire two controllers and views together.

Prerequisites

You need git to clone the repository. You can get git from http://git-scm.com/.

You must have node.js and its package manager (npm) installed for used the included development tools. You can get them from http://nodejs.org/.

Directory Layout

app/                    --> all of the source files for the application
  app.css               --> default stylesheet
  components/           --> all app specific modules
    version/              --> version related components
      version.js                 --> version module declaration and basic "version" value service
      version-directive.js       --> custom directive that returns the current app version
      interpolate-filter.js      --> custom interpolation filter
  view1/                --> the view1 view template and logic
    view1.html            --> the partial template
    view1.js              --> the controller logic
  view2/                --> the view2 view template and logic
    view2.html            --> the partial template
    view2.js              --> the controller logic
  app.js                --> main application module
  index.html            --> app layout file (the main html template file of the app)
images/                 --> (optional) images needed to the application
lib/                    --> libraries (AngularJS and Bootstrap, namely)
  angular/              --> AngularJS version 1.5.5
  bootstrap/            --> Bootstrap version 3.3.6
    css/                --> Boostrap CSS classes (all)
    fonts/              --> fonts provided by Bootstrap
    ui-boostrap-tpls-1.3.1-min.js   --> Angular directives for Bootstrap (UI Bootstrap)
.gitignore              --> files and folders to ignore under Git
.jshintrc               --> configuration file for JSHint
bs-config.js            --> configuration file for browser-sync
package.json            --> metadata, dependencies and npm scripts
README.md               --> this document

Note

This project was created for teaching purpose. AngularJS and Bootstrap should be installed with npm or bower instead of being downloaded in a lib folder. Due to some limitations on the lab computers, this was not possible.

For the students enrolled in the course: please, notice that all the development tools provided by npm (and present in the package.json file) do not work on the lab desktop computers.