diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 2d714534..39597592 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,3 +1,49 @@ +## Dev Environment + +Before you start, tools you will need: +* Download and install [git](http://git-scm.com/downloads) +* Download and install [nodeJS](http://nodejs.org/download/) + +####First time: +`git clone https://github.com/thomasstreet/famous-angular.git` + +`npm install` + +`npm install -g gulp` + + +####Thereafter: +Clone the submodules and install the frontend dependencies inside of your example folder. + +`git submodule update --init --recursive` + +`cd famous-angular-examples` + +`bower install` + +`cd ..` + +`npm start` + +Npm start will use gulp to concatenate files into famous-angular.js, which is built into the app folder. It will also watch for changes inside app and livereload as necessary. + +Then open http://localhost:4000. + +####To develop the library using the famous-angular-examples submodule + +`gulp dev` + +####To build the docs + +`gulp docs` + +####To run tests +Ensure that you have the [karma](http://karma-runner.github.io/0.12/intro/installation.html) command line interface installed. +'npm install -g karma-cli' + +`karma start' + + ## Contribution Guidelines When you commit your messages, follow this convention : diff --git a/README.md b/README.md index d939fb04..030532c9 100644 --- a/README.md +++ b/README.md @@ -1,32 +1,34 @@ # Famo.us/Angular [![Build Status](https://travis-ci.org/Famous/famous-angular.svg?branch=master)](https://travis-ci.org/Famous/famous-angular) -Famo.us/Angular is an AngularJS-driven framework for building Famo.us apps. +Add Famo.us interactions and animations to any AngularJS application and build Famo.us applications with AngularJS. + +Using F/A, you can: +* Create Famo.us apps using familiar AngularJS tools like controllers, directives, and services. +* Bring rich Famo.us animations to new or existing AngularJS apps. +* Use HTML to declare Famo.us UIs, complete with Angular's two-way databinding. +* Easily integrate Famo.us and AngularJS apps. ###Read More [Project Site](https://famo.us/angular) + ###Download [Famo.us/Angular Starter Kit](http://code.famo.us/famous-angular/latest/famous-angular-starter-kit.zip?src=github-readme) or `bower install famous-angular` -Using F/A, you can: -* Create Famo.us apps using familiar AngularJS tools like controllers, directives, and services. -* Bring rich Famo.us animations to new or existing AngularJS apps. -* Use HTML to declare Famo.us UIs, complete with Angular's two-way databinding. -* Easily integrate Famo.us and AngularJS apps. - - -##Project Roadmap +###Sample projects and generators +* [Famo.us/Angular Starter Project](https://github.com/thomasstreet/famous-angular-starter) +* [Famo.us/Angular Yeoman Generator](http://github.com/thaiat/generator-angular-famous-ionic) *(community-maintained) +* [Flickrous](https://github.com/zackbrown) — a simple Flickr example app +* [Famo.us/Angular Homepage Source Code](https://github.com/thomasstreet/famous-angular-docs/tree/master/app) -[https://www.pivotaltracker.com/n/projects/1119890](https://www.pivotaltracker.com/n/projects/1119890) -Contact [famous-angular@thomasstreet.com](mailto:famous-angular@thomasstreet.com) if you want to claim tasks or contribute to the roadmap. -##Running (For using F/A in your Angular app) +##Installation -####Before you start, tools you will need +####Before you start, tools you will need: * Download and install [git](http://git-scm.com/downloads) * Download and install [nodeJS](http://nodejs.org/download/) * Install bower `npm install -g bower` @@ -39,80 +41,23 @@ Contact [famous-angular@thomasstreet.com](mailto:famous-angular@thomasstreet.com ``` * Add`` to the `
` of your index.html -* Add the `famous.angular` module to your Angular module list (e.g. in a main app.js file: `angular.module('yourMainModule',['famous.angular', 'ui.router', 'ngAnimate'])`) +* Add the `famous.angular` module to your Angular module list (e.g. in a main app.js file: `angular.module('yourMainModule', ['famous.angular'])`) * And add an ``, or just ` `, or just `