air9/web-app-sa

The front-end javascript application for the AAT South Africa website AAT WEB APP (SA) =============== This is the source for the frontend javascript client of AAT South Africa All data is sourced via requests to AAT SA Content REST API. Tools used : - AngularJS 1.x (latest) - Bower - Gulp - Bootstrap - SASS - jQuery Testing : - Jasmine - Karma - Protractor Setup --------------- ``` npm install ``` Builds ------------- The current tooling is built around Gulp (gulpjs.com) Then once installed you can run from the 'gulp' command from the main content root. ``` gulp ``` Server ------------- This site is flat HTML so any webserver will run the app. One NodeJS webserver that is very good while developing is live-server (npmjs.com) - Install via // npm install -g live-server - cd ./app ``` live-server ``` In production we recommend using Docker + Nginx Demo api content: ``` node fake_api_server.js ``` Core Files ------------- The core CSS is located from within the SASS folder, and includes the vendor libs Bootstrap. The core JS files and components are located within "./app/sites/", the main JS is "app/app.js" Please adjust these to meet your specific requirements. Components & Microservices -------------------------- The application architecture is based around the component model along with supporting "microservices" from the API. @see : - en.wikipedia.org - en.wikipedia.org CSS ------------- All CSS work should be worked on within the SASS folder and via Gulp compiled to a single minified CSS file. This is all setup currently and only the sass files need to updated / created. JS ------------- All JS work should be worked on within the SITE folder + root level 'app.js' and via gulp compiled to a single uglified JS file. This is setup and working. Libraries ------------- All frontend tools should be added via Bower install --save; and build / test tools should be added via npm …